|
|
//+---------------------------------------------------------------------------
//
// Microsoft Windows
// Copyright (C) Microsoft Corporation, 1992-1999.
//
// File: cryptui.h
//
// Contents: Common Cryptographic Dialog API Prototypes and Definitions
//
//----------------------------------------------------------------------------
#ifndef __CRYPTUI_H__
#define __CRYPTUI_H__
#if defined (_MSC_VER) && (_MSC_VER >= 1020)
#pragma once
#endif
#include <prsht.h>
#include <wintrust.h>
#include <certca.h>
#include <cryptuiapi.h>
#ifdef __cplusplus
extern "C" {#endif
#include <pshpack8.h>
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// the functions which return property sheet pages take this callback as one of the parameters in
// the input structure. it is then called when each page is about to be created and when each page
// is about to be destroyed. the messages are PSPCB_CREATE when a page is about to be created and
// PSPCB_RELEASE when a page is about to be destroyed. the pvCallbackData parameter in the callback
// is the pvoid that was passed in with the callback in the input structure.
typedef BOOL (WINAPI * PFNCPROPPAGECALLBACK)( HWND hWndPropPage, UINT uMsg, void *pvCallbackData);
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, may a combination of any of the flags below (OPTIONAL)
// szTitle title for the window (OPTIONAL)
// pCertContext the cert context that is to be displayed
// rgszPurposes array of purposes that this cert is to be validated for (OPTIONAL)
// cPurposes number of purposes (OPTIONAL)
// pCryptProviderData/hWVTStateData if WinVerifyTrust has already been called for the cert (OPTIONAL)
// then pass in a pointer to the state struct that was
// acquired through a call to WTHelperProvDataFromStateData(),
// or pass in the hWVTStateData of the WINTRUST_DATA struct
// if WTHelperProvDataFromStateData() was not called.
// if pCryptProviderData/hWVTStateData is used then
// fpCryptProviderDataTrustedUsage, idxSigner, idxCert, and
// fCounterSignature must be set
// fpCryptProviderDataTrustedUsage if WinVerifyTrust was called this is the result of whether (OPTIONAL)
// the cert was trusted
// idxSigner the index of the signer to view (OPTIONAL)
// idxCert the index of the cert that is being viewed within the (OPTIONAL)
// signer chain. the cert context of this cert MUST match
// pCertContext
// fCounterSigner set to TRUE if a counter signature is being viewed. if (OPTIONAL)
// this is TRUE then idxCounterSigner must be valid
// idxCounterSigner the index of the counter signer to view (OPTIONAL)
// cStores Count of other stores to search when building and (OPTIONAL)
// validating chain
// rghStores Array of other stores to search when buliding and (OPTIONAL)
// validating chain
// cPropSheetPages number of extra pages to add to the dialog. (OPTIONAL)
// rgPropSheetPages extra pages to add to the dialog. (OPTIONAL)
// each page in this array will NOT recieve the lParam in
// the PROPSHEET structure as the lParam in the
// WM_INITDIALOG, instead it will receive a pointer to a
// CRYPTUI_INITDIALOG_STRUCT (defined below) which contains
// the lParam in the PROPSSHEET structure AND the
// PCCERT_CONTEXT for which the page is being displayed.
// nStartPage this is the index of the initial page that will be
// displayed. if the upper most bit (0x8000) is set then
// the index is assumed to index rgPropSheetPages
// (after the upper most bit has been stripped off. eg.
// 0x8000 will indicate the first page in rgPropSheetPages),
// if the upper most bit is 0 then nStartPage will be the
// starting index of the default certificate dialog pages.
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// dwFlags
#define CRYPTUI_HIDE_HIERARCHYPAGE 0x00000001
#define CRYPTUI_HIDE_DETAILPAGE 0x00000002
#define CRYPTUI_DISABLE_EDITPROPERTIES 0x00000004
#define CRYPTUI_ENABLE_EDITPROPERTIES 0x00000008
#define CRYPTUI_DISABLE_ADDTOSTORE 0x00000010
#define CRYPTUI_ENABLE_ADDTOSTORE 0x00000020
#define CRYPTUI_ACCEPT_DECLINE_STYLE 0x00000040
#define CRYPTUI_IGNORE_UNTRUSTED_ROOT 0x00000080
#define CRYPTUI_DONT_OPEN_STORES 0x00000100
#define CRYPTUI_ONLY_OPEN_ROOT_STORE 0x00000200
#define CRYPTUI_WARN_UNTRUSTED_ROOT 0x00000400 // For use with viewing of certificates on remote
// machines only. If this flag is used rghStores[0]
// must be the handle of the root store on the remote machine.
#define CRYPTUI_ENABLE_REVOCATION_CHECKING 0x00000800 // This flag is only valid if pCryptProviderData/hWVTStateData
// is not passed in.
#define CRYPTUI_WARN_REMOTE_TRUST 0x00001000
#define CRYPTUI_DISABLE_EXPORT 0x00002000 // If this flag is set, then the "Copy to file" button will be
// disabled on the Detail page.
// Revocation flags is only valid if pCryptProviderData/hWVTStateData is not passed in.
#define CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT 0x00004000
#define CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN 0x00008000
#define CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT CRYPTUI_ENABLE_REVOCATION_CHECKING // Changed the default behavior
// to not check root.
// Following is a flag for internal use only!!
#define CRYPTUI_TREEVIEW_PAGE_FLAG 0x80000000
typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
PCCERT_CONTEXT pCertContext; LPCSTR * rgszPurposes; // OPTIONAL
DWORD cPurposes; // OPTIONAL
union { CRYPT_PROVIDER_DATA const * pCryptProviderData; // OPTIONAL
HANDLE hWVTStateData; // OPTIONAL
}; BOOL fpCryptProviderDataTrustedUsage;// OPTIONAL
DWORD idxSigner; // OPTIONAL
DWORD idxCert; // OPTIONAL
BOOL fCounterSigner; // OPTIONAL
DWORD idxCounterSigner; // OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
DWORD nStartPage;} CRYPTUI_VIEWCERTIFICATE_STRUCTW, *PCRYPTUI_VIEWCERTIFICATE_STRUCTW;typedef const CRYPTUI_VIEWCERTIFICATE_STRUCTW *PCCRYPTUI_VIEWCERTIFICATE_STRUCTW;
typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
PCCERT_CONTEXT pCertContext; LPCSTR * rgszPurposes; // OPTIONAL
DWORD cPurposes; // OPTIONAL
union { CRYPT_PROVIDER_DATA const * pCryptProviderData; // OPTIONAL
HANDLE hWVTStateData; // OPTIONAL
}; BOOL fpCryptProviderDataTrustedUsage;// OPTIONAL
DWORD idxSigner; // OPTIONAL
DWORD idxCert; // OPTIONAL
BOOL fCounterSigner; // OPTIONAL
DWORD idxCounterSigner; // OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
DWORD nStartPage;} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;typedef const CRYPTUI_VIEWCERTIFICATE_STRUCTA *PCCRYPTUI_VIEWCERTIFICATE_STRUCTA;
//
// pfPropertiesChanged this will be set by the dialog proc to inform the caller
// if any properties have been changed on certs in the chain
// while the dialog was open
//
BOOLWINAPICryptUIDlgViewCertificateW( IN PCCRYPTUI_VIEWCERTIFICATE_STRUCTW pCertViewInfo, OUT BOOL *pfPropertiesChanged // OPTIONAL
);
BOOLWINAPICryptUIDlgViewCertificateA( IN PCCRYPTUI_VIEWCERTIFICATE_STRUCTA pCertViewInfo, OUT BOOL *pfPropertiesChanged // OPTIONAL
);
#ifdef UNICODE
#define CryptUIDlgViewCertificate CryptUIDlgViewCertificateW
#define PCRYPTUI_VIEWCERTIFICATE_STRUCT PCRYPTUI_VIEWCERTIFICATE_STRUCTW
#define CRYPTUI_VIEWCERTIFICATE_STRUCT CRYPTUI_VIEWCERTIFICATE_STRUCTW
#define PCCRYPTUI_VIEWCERTIFICATE_STRUCT PCCRYPTUI_VIEWCERTIFICATE_STRUCTW
#else
#define CryptUIDlgViewCertificate CryptUIDlgViewCertificateA
#define PCRYPTUI_VIEWCERTIFICATE_STRUCT PCRYPTUI_VIEWCERTIFICATE_STRUCTA
#define CRYPTUI_VIEWCERTIFICATE_STRUCT CRYPTUI_VIEWCERTIFICATE_STRUCTA
#define PCCRYPTUI_VIEWCERTIFICATE_STRUCT PCCRYPTUI_VIEWCERTIFICATE_STRUCTA
#endif
//
// this struct is passed as the lParam in the WM_INITDIALOG call to each
// property sheet that is in the rgPropSheetPages array of the
// CRYPTUI_VIEWCERTIFICATE_STRUCT structure
//
typedef struct tagCRYPTUI_INITDIALOG_STRUCT { LPARAM lParam; PCCERT_CONTEXT pCertContext;} CRYPTUI_INITDIALOG_STRUCT, *PCRYPTUI_INITDIALOG_STRUCT;
//
// this structure is used in CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT,
// and allows users of MMC to recieve notifications that properties
// on certificates have changed
//
typedef HRESULT (__stdcall * PFNCMMCCALLBACK)(LONG_PTR lNotifyHandle, LPARAM param);
typedef struct tagCRYPTUI_MMCCALLBACK_STRUCT { PFNCMMCCALLBACK pfnCallback; // the address of MMCPropertyChangeNotify()
LONG_PTR lNotifyHandle; // the lNotifyHandle passed to MMCPropertyChangeNotify()
LPARAM param; // the param passed to MMCPropertyChangeNotify()
} CRYPTUI_MMCCALLBACK_STRUCT, *PCRYPTUI_MMCCALLBACK_STRUCT;
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, must be set to 0
// union the szTitle field of the union is only valid if
// CryptUIDlgViewCertificateProperties is being called.
// the pMMCCallback field of the union is only valid if
// CryptUIGetCertificatePropertiesPages is being called.
// Note that if pMMCCallback is non-NULL and
// CryptUIGetCertificatePropertiesPages was called, the
// struct pointed to by pMMCCallback will not be referenced
// by cryptui.dll after the callback has been made to MMC.
// this will allow the original caller of
// CryptUIGetCertificatePropertiesPages to free the struct
// pointed to by pMMCCallback in the actual callback.
// szTitle title for the window (OPTIONAL)
// pMMCCallback this structure is used to callback MMC if properties (OPTIONAL)
// have changed
// pCertContext the cert context that is to be displayed
// pPropPageCallback this callback will be called when each page that is (OPTIONAL)
// returned in the CryptUIGetCertificatePropertiesPages call
// is about to be created or destroyed. if this is NULL no
// callback is made. Note that this is not used if
// CryptUIDlgViewCertificateProperties is called
// pvCallbackData this is uniterpreted data that is passed back when the (OPTIONAL)
// when pPropPageCallback is made
// cStores Count of other stores to search when building and (OPTIONAL)
// validating chain
// rghStores Array of other stores to search when buliding and (OPTIONAL)
// validating chain
// cPropSheetPages number of extra pages to add to the dialog (OPTIONAL)
// rgPropSheetPages extra pages to add to the dialog (OPTIONAL)
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
typedef struct tagCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
union { LPCWSTR szTitle; // OPTIONAL
PCRYPTUI_MMCCALLBACK_STRUCT pMMCCallback;// OPTIONAL
}; PCCERT_CONTEXT pCertContext; PFNCPROPPAGECALLBACK pPropPageCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW, *PCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW;typedef const CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW *PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW;
typedef struct tagCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
union { LPCSTR szTitle; // OPTIONAL
PCRYPTUI_MMCCALLBACK_STRUCT pMMCCallback;// OPTIONAL
}; PCCERT_CONTEXT pCertContext; PFNCPROPPAGECALLBACK pPropPageCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA, *PCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA;typedef const CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA *PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA;
// pfPropertiesChanged this will be set by the dialog proc to inform the caller
// if any properties have been changed on certs in the chain
// while the dialog was open
BOOLWINAPICryptUIDlgViewCertificatePropertiesW( IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW pcsp, OUT BOOL *pfPropertiesChanged // OPTIONAL
);
BOOLWINAPICryptUIDlgViewCertificatePropertiesA( IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA pcsp, OUT BOOL *pfPropertiesChanged // OPTIONAL
);
// NOTE!! when calling this function, the following parameters of the
// CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT struct are unused
// cPropSheetPages
// rgPropSheetPages
BOOLWINAPICryptUIGetCertificatePropertiesPagesW( IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW pcsp, OUT BOOL *pfPropertiesChanged, // OPTIONAL
OUT PROPSHEETPAGEW **prghPropPages, OUT DWORD *pcPropPages );
BOOLWINAPICryptUIGetCertificatePropertiesPagesA( IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA pcsp, OUT BOOL *pfPropertiesChanged, // OPTIONAL
OUT PROPSHEETPAGEA **prghPropPages, OUT DWORD *pcPropPages );
BOOLWINAPICryptUIFreeCertificatePropertiesPagesW( IN PROPSHEETPAGEW *rghPropPages, IN DWORD cPropPages );
BOOLWINAPICryptUIFreeCertificatePropertiesPagesA( IN PROPSHEETPAGEA *rghPropPages, IN DWORD cPropPages );
#ifdef UNICODE
#define CryptUIDlgViewCertificateProperties CryptUIDlgViewCertificatePropertiesW
#define PCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT PCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW
#define CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW
#define PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW
#define CryptUIGetCertificatePropertiesPages CryptUIGetCertificatePropertiesPagesW
#define CryptUIFreeCertificatePropertiesPages CryptUIFreeCertificatePropertiesPagesW
#else
#define CryptUIDlgViewCertificateProperties CryptUIDlgViewCertificatePropertiesA
#define PCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT PCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA
#define CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT CRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA
#define PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCT PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA
#define CryptUIGetCertificatePropertiesPages CryptUIGetCertificatePropertiesPagesA
#define CryptUIFreeCertificatePropertiesPages CryptUIFreeCertificatePropertiesPagesA
#endif
//
// The certificate properties property sheet dialog is extensible via a callback mechanism.
// A client needs to register their callback using CryptRegisterDefaultOIDFunction, and,
// if they need to unregister it they should use CryptUnregisterDefaultOIDFunction.
// The form for calling these functions is given below
//
// CryptRegisterDefaultOIDFunction(
// 0,
// CRYPTUILDLG_CERTPROP_PAGES_CALLBACK,
// CRYPT_REGISTER_FIRST_INDEX,
// L"c:\\fully qualified path\\dll_being_registered.dll"); <<----- your dll name
//
// CryptUnregisterDefaultOIDFunction(
// 0,
// CRYPTUILDLG_CERTPROP_PAGES_CALLBACK,
// L"c:\\fully qualified path\\dll_being_registered.dll"); <<----- your dll name
//
// NOTE: Per the documentation on CryptRegisterDefaultOIDFunction in wincrypt.h,
// the dll name may contain environment-variable strings
// which are ExpandEnvironmentStrings()'ed before loading the Dll.
//
#define MAX_CLIENT_PAGES 20
#define CRYPTUILDLG_CERTPROP_PAGES_CALLBACK "CryptUIDlgClientCertPropPagesCallback"
//
//
// The typedef for the callback function which resides in the registered dll is given
// below. Note that the callback must have the name #defined by
// CRYPTUILDLG_CERTPROP_PAGES_CALLBACK
//
// pCertContext - The certificate for which the properties are being displayed.
// rgPropPages - An array of PropSheetPageW structures that are to be filled in by
// the client with the property pages to be shown.
// pcPropPages - A pointer to a DWORD that on input contains the maximum number of
// PropSheetPages the client may supply, and on output must have been
// filled in by the client with the number of pages they supplied in
// rgPropPages.
//
// Return Value: The client should return TRUE if they wish to show extra property pages,
// in this case pcPropPages must >= 1 and rgPropPages must have the
// corresponding number of pages. or, return FALSE if no pages are suplied.
typedef BOOL (WINAPI *PFN_CRYPTUIDLG_CERTPROP_PAGES_CALLBACK) (IN PCCERT_CONTEXT pCertContext, OUT PROPSHEETPAGEW *rgPropPages, IN OUT DWORD *pcPropPages);
/////////////////////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, may a combination of any of the flags below
// szTitle title for the window (OPTIONAL)
// pCTLContext the ctl context that is to be displayed
// cCertSearchStores; count of other stores to search for the certs contained (OPTIONAL)
// in the ctl
// rghCertSearchStores; array of other stores to search for the certs contained (OPTIONAL)
// in the ctl
// cStores Count of other stores to search when building and (OPTIONAL)
// validating chain of the cert which signed the ctl
// and the certs contained in the ctl
// rghStores Array of other stores to search when buliding and (OPTIONAL)
// validating chain of the cert which signed the ctl
// and the certs contained in the ctl
// cPropSheetPages number of extra pages to add to the dialog (OPTIONAL)
// rgPropSheetPages extra pages to add to the dialog (OPTIONAL)
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// dwFlags
#define CRYPTUI_HIDE_TRUSTLIST_PAGE 0x00000001
typedef struct tagCRYPTUI_VIEWCTL_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
PCCTL_CONTEXT pCTLContext; DWORD cCertSearchStores; // OPTIONAL
HCERTSTORE * rghCertSearchStores;// OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWCTL_STRUCTW, *PCRYPTUI_VIEWCTL_STRUCTW;typedef const CRYPTUI_VIEWCTL_STRUCTW *PCCRYPTUI_VIEWCTL_STRUCTW;
typedef struct tagCRYPTUI_VIEWCTL_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
PCCTL_CONTEXT pCTLContext; DWORD cCertSearchStores; // OPTIONAL
HCERTSTORE * rghCertSearchStores;// OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWCTL_STRUCTA, *PCRYPTUI_VIEWCTL_STRUCTA;typedef const CRYPTUI_VIEWCTL_STRUCTA *PCCRYPTUI_VIEWCTL_STRUCTA;
BOOLWINAPICryptUIDlgViewCTLW( IN PCCRYPTUI_VIEWCTL_STRUCTW pcvctl );
BOOLWINAPICryptUIDlgViewCTLA( IN PCCRYPTUI_VIEWCTL_STRUCTA pcvctl );
#ifdef UNICODE
#define CryptUIDlgViewCTL CryptUIDlgViewCTLW
#define PCRYPTUI_VIEWCTL_STRUCT PCRYPTUI_VIEWCTL_STRUCTW
#define CRYPTUI_VIEWCTL_STRUCT CRYPTUI_VIEWCTL_STRUCTW
#define PCCRYPTUI_VIEWCTL_STRUCT PCCRYPTUI_VIEWCTL_STRUCTW
#else
#define CryptUIDlgViewCTL CryptUIDlgViewCTLA
#define PCRYPTUI_VIEWCTL_STRUCT PCRYPTUI_VIEWCTL_STRUCTA
#define CRYPTUI_VIEWCTL_STRUCT CRYPTUI_VIEWCTL_STRUCTA
#define PCCRYPTUI_VIEWCTL_STRUCT PCCRYPTUI_VIEWCTL_STRUCTA
#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, may a combination of any of the flags below
// szTitle title for the window (OPTIONAL)
// pCTLContext the ctl context that is to be displayed
// cStores count of other stores to search for the cert which (OPTIONAL)
// signed the crl and to build and validate the
// cert's chain
// rghStores array of other stores to search for the cert which (OPTIONAL)
// signed the crl and to build and validate the
// cert's chain
// cPropSheetPages number of extra pages to add to the dialog (OPTIONAL)
// rgPropSheetPages extra pages to add to the dialog (OPTIONAL)
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// dwFlags
#define CRYPTUI_HIDE_REVOCATIONLIST_PAGE 0x00000001
typedef struct tagCRYPTUI_VIEWCRL_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
PCCRL_CONTEXT pCRLContext; DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWCRL_STRUCTW, *PCRYPTUI_VIEWCRL_STRUCTW;typedef const CRYPTUI_VIEWCRL_STRUCTW *PCCRYPTUI_VIEWCRL_STRUCTW;
typedef struct tagCRYPTUI_VIEWCRL_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
PCCRL_CONTEXT pCRLContext; DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWCRL_STRUCTA, *PCRYPTUI_VIEWCRL_STRUCTA;typedef const CRYPTUI_VIEWCRL_STRUCTA *PCCRYPTUI_VIEWCRL_STRUCTA;
BOOLWINAPICryptUIDlgViewCRLW( IN PCCRYPTUI_VIEWCRL_STRUCTW pcvcrl );
BOOLWINAPICryptUIDlgViewCRLA( IN PCCRYPTUI_VIEWCRL_STRUCTA pcvcrl );
#ifdef UNICODE
#define CryptUIDlgViewCRL CryptUIDlgViewCRLW
#define PCRYPTUI_VIEWCRL_STRUCT PCRYPTUI_VIEWCRL_STRUCTW
#define CRYPTUI_VIEWCRL_STRUCT CRYPTUI_VIEWCRL_STRUCTW
#define PCCRYPTUI_VIEWCRL_STRUCT PCCRYPTUI_VIEWCRL_STRUCTW
#else
#define CryptUIDlgViewCRL CryptUIDlgViewCRLA
#define PCRYPTUI_VIEWCRL_STRUCT PCRYPTUI_VIEWCRL_STRUCTA
#define CRYPTUI_VIEWCRL_STRUCT CRYPTUI_VIEWCRL_STRUCTA
#define PCCRYPTUI_VIEWCRL_STRUCT PCCRYPTUI_VIEWCRL_STRUCTA
#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, may a combination of any of the flags below
// szTitle title for the window (OPTIONAL)
// pSignerInfo the signer info struct that is to be displayed
// hMsg the HCRYPTMSG that the signer info was extracted from
// pszOID an OID that signifies what the certificate that did the (OPTIONAL)
// signing whould be validated for. for instance if this is
// being called to view the signature of a CTL the
// szOID_KP_CTL_USAGE_SIGNING OID should be passed in.
// if this is NULL then the certificate is only validated
// cryptographicaly and not for usages.
// dwReserved reserved for future use and must be set to NULL
// cStores count of other stores to search for the cert which (OPTIONAL)
// did the signing and to build and validate the
// cert's chain
// rghStores array of other stores to search for the cert which (OPTIONAL)
// did the signing and to build and validate the
// cert's chain
// cPropSheetPages number of extra pages to add to the dialog (OPTIONAL)
// rgPropSheetPages extra pages to add to the dialog (OPTIONAL)
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// dwFlags
#define CRYPTUI_HIDE_TRUSTLIST_PAGE 0x00000001
typedef struct tagCRYPTUI_VIEWSIGNERINFO_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
CMSG_SIGNER_INFO const *pSignerInfo; HCRYPTMSG hMsg; LPCSTR pszOID; // OPTIONAL
DWORD_PTR dwReserved; DWORD cStores; // OPTIONAL
HCERTSTORE *rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWSIGNERINFO_STRUCTW, *PCRYPTUI_VIEWSIGNERINFO_STRUCTW;typedef const CRYPTUI_VIEWSIGNERINFO_STRUCTW *PCCRYPTUI_VIEWSIGNERINFO_STRUCTW;
typedef struct tagCRYPTUI_VIEWSIGNERINFO_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
CMSG_SIGNER_INFO const *pSignerInfo; HCRYPTMSG hMsg; LPCSTR pszOID; // OPTIONAL
DWORD_PTR dwReserved; DWORD cStores; // OPTIONAL
HCERTSTORE *rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWSIGNERINFO_STRUCTA, *PCRYPTUI_VIEWSIGNERINFO_STRUCTA;typedef const CRYPTUI_VIEWSIGNERINFO_STRUCTA *PCCRYPTUI_VIEWSIGNERINFO_STRUCTA;
BOOLWINAPICryptUIDlgViewSignerInfoW( IN PCCRYPTUI_VIEWSIGNERINFO_STRUCTW pcvsi );
BOOLWINAPICryptUIDlgViewSignerInfoA( IN PCCRYPTUI_VIEWSIGNERINFO_STRUCTA pcvsi );
#ifdef UNICODE
#define CryptUIDlgViewSignerInfo CryptUIDlgViewSignerInfoW
#define PCRYPTUI_VIEWSIGNERINFO_STRUCT PCRYPTUI_VIEWSIGNERINFO_STRUCTW
#define CRYPTUI_VIEWSIGNERINFO_STRUCT CRYPTUI_VIEWSIGNERINFO_STRUCTW
#define PCCRYPTUI_VIEWSIGNERINFO_STRUCT PCCRYPTUI_VIEWSIGNERINFO_STRUCTW
#else
#define CryptUIDlgViewSignerInfo CryptUIDlgViewSignerInfoA
#define PCRYPTUI_VIEWSIGNERINFO_STRUCT PCRYPTUI_VIEWSIGNERINFO_STRUCTA
#define CRYPTUI_VIEWSIGNERINFO_STRUCT CRYPTUI_VIEWSIGNERINFO_STRUCTA
#define PCCRYPTUI_VIEWSIGNERINFO_STRUCT PCCRYPTUI_VIEWSIGNERINFO_STRUCTA
#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, must be set to 0
// szTitle title for the window (OPTIONAL)
// choice the form of the message that is to have its signers displayed
// u either an encoded message or a message handle
// EncodedMessage a data blob which contains a pointer to the encoded data
// and the count of encoded bytes
// hMsg a message handle
// szFileName the fully qualified file name, should be passed in if (OPTIONAL)
// signatures on a file are being viewed
// pPropPageCallback this callback will be called when each page that is (OPTIONAL)
// returned in the CryptUIGetViewSignaturesPages call
// is about to be created or destroyed. if this is NULL no
// callback is made.
// pvCallbackData this is uniterpreted data that is passed back when the (OPTIONAL)
// when pPropPageCallback is made
// cStores count of other stores to search for the cert which (OPTIONAL)
// did the signing and to build and validate the
// cert's chain
// rghStores array of other stores to search for the cert which (OPTIONAL)
// did the signing and to build and validate the
// cert's chain
// cPropSheetPages number of extra pages to add to the dialog (OPTIONAL)
// rgPropSheetPages extra pages to add to the dialog (OPTIONAL)
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// for the coice field of the CRYPTUI_VIEWSIGNATURES_STRUCT structure
#define EncodedMessage_Chosen 1
#define hMsg_Chosen 2
typedef struct tagCRYPTUI_VIEWSIGNATURES_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
unsigned short choice; union { CRYPT_DATA_BLOB EncodedMessage; HCRYPTMSG hMsg; } u; LPCWSTR szFileName; // OPTIONAL
PFNCPROPPAGECALLBACK pPropPageCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWSIGNATURES_STRUCTW, *PCRYPTUI_VIEWSIGNATURES_STRUCTW;typedef const CRYPTUI_VIEWSIGNATURES_STRUCTW *PCCRYPTUI_VIEWSIGNATURES_STRUCTW;
typedef struct tagCRYPTUI_VIEWSIGNATURES_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
unsigned short choice; union { CRYPT_DATA_BLOB EncodedMessage; HCRYPTMSG hMsg; } u; LPCSTR szFileName; // OPTIONAL
PFNCPROPPAGECALLBACK pPropPageCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
} CRYPTUI_VIEWSIGNATURES_STRUCTA, *PCRYPTUI_VIEWSIGNATURES_STRUCTA;typedef const CRYPTUI_VIEWSIGNATURES_STRUCTA *PCCRYPTUI_VIEWSIGNATURES_STRUCTA;
// NOTE!! when calling this function, the following parameters of the
// CRYPTUI_VIEWSIGNATURES_STRUCT struct are unused
// cPropSheetPages
// rgPropSheetPages
// szTitle
BOOLWINAPICryptUIGetViewSignaturesPagesW( IN PCCRYPTUI_VIEWSIGNATURES_STRUCTW pcvs, OUT PROPSHEETPAGEW **prghPropPages, OUT DWORD *pcPropPages );
BOOLWINAPICryptUIGetViewSignaturesPagesA( IN PCCRYPTUI_VIEWSIGNATURES_STRUCTA pcvs, OUT PROPSHEETPAGEA **prghPropPages, OUT DWORD *pcPropPages );
BOOLWINAPICryptUIFreeViewSignaturesPagesW( IN PROPSHEETPAGEW *rghPropPages, IN DWORD cPropPages );
BOOLWINAPICryptUIFreeViewSignaturesPagesA( IN PROPSHEETPAGEA *rghPropPages, IN DWORD cPropPages );
#ifdef UNICODE
#define CryptUIGetViewSignaturesPages CryptUIGetViewSignaturesPagesW
#define CryptUIFreeViewSignaturesPages CryptUIFreeViewSignaturesPagesW
#define PCRYPTUI_VIEWSIGNATURES_STRUCT PCRYPTUI_VIEWSIGNATURES_STRUCTW
#define CRYPTUI_VIEWSIGNATURES_STRUCT CRYPTUI_VIEWSIGNATURES_STRUCTW
#define PCCRYPTUI_VIEWSIGNATURES_STRUCT PCCRYPTUI_VIEWSIGNATURES_STRUCTW
#else
#define CryptUIGetViewSignaturesPages CryptUIGetViewSignaturesPagesA
#define CryptUIFreeViewSignaturesPages CryptUIFreeViewSignaturesPagesA
#define PCRYPTUI_VIEWSIGNATURES_STRUCT PCRYPTUI_VIEWSIGNATURES_STRUCTA
#define CRYPTUI_VIEWSIGNATURES_STRUCT CRYPTUI_VIEWSIGNATURES_STRUCTA
#define PCCRYPTUI_VIEWSIGNATURES_STRUCT PCCRYPTUI_VIEWSIGNATURES_STRUCTA
#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// the select store dialog can be passed a callback which is called to validate the store that the
// user selected. Return TRUE to accept the store, or FALSE to reject the store. It TRUE is
// returned then the store will be returned to the caller of CryptUIDlg\, if FALSE is returned
// then the select store dialog will remain displayed so the user may make another selection
typedef BOOL (WINAPI * PFNCVALIDATESTOREPROC)( HCERTSTORE hStore, HWND hWndSelectStoreDialog, void *pvCallbackData);
/////////////////////////////////////////////////////////////////////////////////////////////////////
// these two parameters are passed to the CertEnumSystemStore call and the stores that are
// enumerated via that call are added to the store selection list.
//
// dwFlags CertEnumSystemStore
// pvSystemStoreLocationPara CertEnumSystemStore
typedef struct _STORENUMERATION_STRUCT { DWORD dwFlags; void * pvSystemStoreLocationPara;} STORENUMERATION_STRUCT, *PSTORENUMERATION_STRUCT;typedef const STORENUMERATION_STRUCT *PCSTORENUMERATION_STRUCT;
/////////////////////////////////////////////////////////////////////////////////////////////////////
// both the array of store handles and the array of enumeration strucs may be used to
// populate the store selection list. if either is not used the count must be set to 0.
// if the array of store handles is used the cert stores must have either been opened
// with the CERT_STORE_SET_LOCALIZED_NAME_FLAG flag, or the CertSetStoreProperty function
// must have been called with the CERT_STORE_LOCALIZED_NAME_PROP_ID flag. if the
// CryptUIDlgSelectStore function is unable to obtain a name for a store that store will not
// be displayed.
//
// cStores count of stores to select from
// rghStores array of stores to select from
// cEnumerationStructs count of enumeration structs
// rgEnumerationStructs array of enumeration structs
typedef struct _STORESFORSELCTION_STRUCT { DWORD cStores; HCERTSTORE * rghStores; DWORD cEnumerationStructs; PCSTORENUMERATION_STRUCT rgEnumerationStructs;} STORESFORSELCTION_STRUCT, *PSTORESFORSELCTION_STRUCT;typedef const STORESFORSELCTION_STRUCT *PCSTORESFORSELCTION_STRUCT;
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags, may a combination of any of the flags below
// szTitle title of the dialog (OPTIONAL)
// szDisplayString a string that will be displayed in the dialog that may (OPTIONAL)
// be used to infor the user what they are selecting a store
// for. if it is not set a default string will be displayed,
// the default resource is IDS_SELECT_STORE_DEFAULT
// pStoresForSelection a struct that contains the stores that are to be selected
// from. the stores can be in two different formats, an array
// of store handles and/or an array of enumeration structs
// which will be used to call CertEnumSystemStore
// pValidateStoreCallback a pointer to a PFNCVALIDATESTOREPROC which is used to (OPTIONAL)
// callback the caller of CryptUIDlgSelectStore when the
// user hasselected a store and pressed OK
// pvCallbackData if pValidateStoreCallback is being used this value is (OPTIONAL)
// passed back to the caller when the pValidateStoreCallback
// is made
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// dwFlags
#define CRYPTUI_ALLOW_PHYSICAL_STORE_VIEW 0x00000001
#define CRYPTUI_RETURN_READ_ONLY_STORE 0x00000002
#define CRYPTUI_DISPLAY_WRITE_ONLY_STORES 0x00000004
#define CRYPTUI_VALIDATE_STORES_AS_WRITABLE 0x00000008
typedef struct tagCRYPTUI_SELECTSTORE_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
LPCWSTR szDisplayString; // OPTIONAL
PCSTORESFORSELCTION_STRUCT pStoresForSelection; PFNCVALIDATESTOREPROC pValidateStoreCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
} CRYPTUI_SELECTSTORE_STRUCTW, *PCRYPTUI_SELECTSTORE_STRUCTW;typedef const CRYPTUI_SELECTSTORE_STRUCTW *PCCRYPTUI_SELECTSTORE_STRUCTW;
typedef struct tagCRYPTUI_SELECTSTORE_STRUCTA { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
LPCSTR szDisplayString; // OPTIONAL
PCSTORESFORSELCTION_STRUCT pStoresForSelection; PFNCVALIDATESTOREPROC pValidateStoreCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
} CRYPTUI_SELECTSTORE_STRUCTA, *PCRYPTUI_SELECTSTORE_STRUCTA;typedef const CRYPTUI_SELECTSTORE_STRUCTA *PCCRYPTUI_SELECTSTORE_STRUCTA;
//
// the HCERTSTORE that is returned must be closed by calling CertCloseStore
//
HCERTSTOREWINAPICryptUIDlgSelectStoreW( IN PCCRYPTUI_SELECTSTORE_STRUCTW pcss );
HCERTSTOREWINAPICryptUIDlgSelectStoreA( IN PCCRYPTUI_SELECTSTORE_STRUCTA pcss );
#ifdef UNICODE
#define CryptUIDlgSelectStore CryptUIDlgSelectStoreW
#define PCRYPTUI_SELECTSTORE_STRUCT PCRYPTUI_SELECTSTORE_STRUCTW
#define CRYPTUI_SELECTSTORE_STRUCT CRYPTUI_SELECTSTORE_STRUCTW
#define PCCRYPTUI_SELECTSTORE_STRUCT PCCRYPTUI_SELECTSTORE_STRUCTW
#else
#define CryptUIDlgSelectStore CryptUIDlgSelectStoreA
#define PCRYPTUI_SELECTSTORE_STRUCT PCRYPTUI_SELECTSTORE_STRUCTA
#define CRYPTUI_SELECTSTORE_STRUCT CRYPTUI_SELECTSTORE_STRUCTA
#define PCCRYPTUI_SELECTSTORE_STRUCT PCCRYPTUI_SELECTSTORE_STRUCTA
#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
#if (0) //DSIE: 7/02/2002 moved to CryptUIAPI.h per consent degree.
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// The select cert dialog can be passed a filter proc to reduce the set of certificates
// displayed. Return TRUE to display the certificate and FALSE to hide it. If TRUE is
// returned then optionally the pfInitialSelectedCert boolean may be set to TRUE to indicate
// to the dialog that this cert should be the initially selected cert. Note that the
// most recent cert that had the pfInitialSelectedCert boolean set during the callback will
// be the initially selected cert.
typedef BOOL (WINAPI * PFNCFILTERPROC)( PCCERT_CONTEXT pCertContext, BOOL *pfInitialSelectedCert, void *pvCallbackData);#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// Certificates may be viewed by the user when selecting certificates from the select certificate
// dialog. This callback will allow the caller of the select certificate dialog to handle the
// displaying of those certificates. This may be useful if the caller wishes to call WinVerifyTrust
// with their own policy module and display the certificate with that WinVerifyTrust state. If
// FALSE is returned from this callback it is assumed that the select certificate dialog will be
// responsible for dislaying the certificate in question. If TRUE is returned it is assumed that the
// display of the certificate was already handled.
typedef BOOL (WINAPI * PFNCCERTDISPLAYPROC)( PCCERT_CONTEXT pCertContext, HWND hWndSelCertDlg, void *pvCallbackData);
/////////////////////////////////////////////////////////////////////////////////////////////////////
//
// dwSize size of this struct
// hwndParent parent of this dialog (OPTIONAL)
// dwFlags flags:
// CRYPTUI_SELECTCERT_MULTISELECT -
// if this flag is set then CryptUIDlgSelectCertificate
// will return NULL, and the hSelectedCertStore
// parameter must contain a valid store handle that
// will be populated with all the selected certificates.
// dwDontUseColumn This can be used to disable the display of certain (OPTIONAL)
// columns. It can be set with any comibnation of the
// column flags below
// szTitle title of the dialog (OPTIONAL)
// szDisplayString a string that will be displayed in the dialog that may (OPTIONAL)
// be used to inform the user what they are selecting a
// a certificate for. if it is not set a default string
// will be displayed. the defualt strings resourece is
// IDS_SELECT_CERT_DEFAULT
// pFilterCallback a pointer to a PFNCMFILTERPROC which is used to filter (OPTIONAL)
// the certificates which are displayed for selection
// pDisplayCallback a pointer to a PFNCCERTDISPLAYPROC which is used to
// handle displaying certificates
// pvCallbackData if either or both pFilterCallback or pDisplayCallback (OPTIONAL)
// are being used this value is passed back to the caller
// when the callbacks are made
// cDisplayStores count of stores that contain the certs to display
// for selection
// rghDisplayStores array of stores that contain the certs to display
// for selection
// cStores count of other stores to search when building chain and (OPTIONAL)
// validating trust of the certs which are displayed, if
// the user choosing a cert would like to view a particular
// cert which is displayed for selection, these stores
// are passed to the CertViewCert dialog
// rghStores array of other stores to search when building chain and (OPTIONAL)
// validating trust of the certs which are displayed, if
// the user choosing a cert would like to view a particular
// cert which is displayed for selection, these stores
// are passed to the CertViewCert dialog
// cPropSheetPages PASS THROUGH - number of pages in rgPropSheetPages array (OPTIONAL)
// rgPropSheetPages PASS THROUGH - extra pages that are passed through (OPTIONAL)
// to the certificate viewing dialog when it is invoked from
// the selection dialog
// hSelectedCertStore This certificate store is passed in by the caller if the (OPTIONAL)
// CRYPTUI_SELECTCERT_MULTISELECT flag is set. The store
// will contain all the selected certificates on return.
//
/////////////////////////////////////////////////////////////////////////////////////////////////////
// flags for dwDontUseColumn
//
// The following are defined in cryptuiapi.h
// #define CRYPTUI_SELECT_ISSUEDTO_COLUMN 0x000000001
// #define CRYPTUI_SELECT_ISSUEDBY_COLUMN 0x000000002
// #define CRYPTUI_SELECT_INTENDEDUSE_COLUMN 0x000000004
// #define CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 0x000000008
// #define CRYPTUI_SELECT_LOCATION_COLUMN 0x000000010
// #define CRYPTUI_SELECT_EXPIRATION_COLUMN 0x000000020
typedef struct tagCRYPTUI_SELECTCERTIFICATE_STRUCTW { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR szTitle; // OPTIONAL
DWORD dwDontUseColumn; // OPTIONAL
LPCWSTR szDisplayString; // OPTIONAL
PFNCFILTERPROC pFilterCallback; // OPTIONAL
PFNCCERTDISPLAYPROC pDisplayCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
DWORD cDisplayStores; HCERTSTORE * rghDisplayStores; DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEW rgPropSheetPages; // OPTIONAL
HCERTSTORE hSelectedCertStore; // OPTIONAL
} CRYPTUI_SELECTCERTIFICATE_STRUCTW, *PCRYPTUI_SELECTCERTIFICATE_STRUCTW;typedef const CRYPTUI_SELECTCERTIFICATE_STRUCTW *PCCRYPTUI_SELECTCERTIFICATE_STRUCTW;
typedef struct tagCRYPTUI_SELECTCERTIFICATE_STRUCT_A { DWORD dwSize; HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCSTR szTitle; // OPTIONAL
DWORD dwDontUseColumn; // OPTIONAL
LPCSTR szDisplayString; // OPTIONAL
PFNCFILTERPROC pFilterCallback; // OPTIONAL
PFNCCERTDISPLAYPROC pDisplayCallback; // OPTIONAL
void * pvCallbackData; // OPTIONAL
DWORD cDisplayStores; HCERTSTORE * rghDisplayStores; DWORD cStores; // OPTIONAL
HCERTSTORE * rghStores; // OPTIONAL
DWORD cPropSheetPages; // OPTIONAL
LPCPROPSHEETPAGEA rgPropSheetPages; // OPTIONAL
HCERTSTORE hSelectedCertStore; // OPTIONAL
} CRYPTUI_SELECTCERTIFICATE_STRUCTA, *PCRYPTUI_SELECTCERTIFICATE_STRUCTA;typedef const CRYPTUI_SELECTCERTIFICATE_STRUCTA *PCCRYPTUI_SELECTCERTIFICATE_STRUCTA;
//
// the PCCERT_CONTEXT that is returned must be released by calling CertFreeCertificateContext().
// if NULL is returned and GetLastError() == 0 then the user dismissed the dialog by hitting the
// "cancel" button, otherwise GetLastError() will contain the last error.
//
PCCERT_CONTEXTWINAPICryptUIDlgSelectCertificateW( IN PCCRYPTUI_SELECTCERTIFICATE_STRUCTW pcsc );
PCCERT_CONTEXTWINAPICryptUIDlgSelectCertificateA( IN PCCRYPTUI_SELECTCERTIFICATE_STRUCTA pcsc );
#ifdef UNICODE
#define CryptUIDlgSelectCertificate CryptUIDlgSelectCertificateW
#define PCRYPTUI_SELECTCERTIFICATE_STRUCT PCRYPTUI_SELECTCERTIFICATE_STRUCTW
#define CRYPTUI_SELECTCERTIFICATE_STRUCT CRYPTUI_SELECTCERTIFICATE_STRUCTW
#define PCCRYPTUI_SELECTCERTIFICATE_STRUCT PCCRYPTUI_SELECTCERTIFICATE_STRUCTW
#else
#define CryptUIDlgSelectCertificate CryptUIDlgSelectCertificateA
#define PCRYPTUI_SELECTCERTIFICATE_STRUCT PCRYPTUI_SELECTCERTIFICATE_STRUCTA
#define CRYPTUI_SELECTCERTIFICATE_STRUCT CRYPTUI_SELECTCERTIFICATE_STRUCTA
#define PCCRYPTUI_SELECTCERTIFICATE_STRUCT PCCRYPTUI_SELECTCERTIFICATE_STRUCTA
#endif
// dwFlags
#define CRYPTUI_SELECTCERT_MULTISELECT 0x00000001
#define CRYPTUI_SELECTCERT_ADDFROMDS 0x00010000
//flags for dwFlags in CRYPTUI_SELECT_CA_STRUCT struct
#define CRYPTUI_DLG_SELECT_CA_FROM_NETWORK 0x0001
#define CRYPTUI_DLG_SELECT_CA_USE_DN 0x0002
#define CRYPTUI_DLG_SELECT_CA_LOCAL_MACHINE_ENUMERATION 0x0004
//-------------------------------------------------------------------------
//
// CRYPTUI_CA_CONTEXT
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_CA_CONTEXT{ DWORD dwSize; LPCWSTR pwszCAName; LPCWSTR pwszCAMachineName;}CRYPTUI_CA_CONTEXT, *PCRYPTUI_CA_CONTEXT;
typedef const CRYPTUI_CA_CONTEXT *PCCRYPTUI_CA_CONTEXT;
//-------------------------------------------------------------------------
//
//
//
// The select certificate authoritiy (CA) dialog can be passed a filter proc to reduce the set of CAs
// displayed. Return TRUE to display the CA and FALSE to hide it. If TRUE is
// returned then optionally the pfInitialSelectedCert boolean may be set to TRUE to indicate
// to the dialog that this CA should be the initially selected CA. Note that the
// most recent cert that had the pfInitialSelectedCert boolean set during the callback will
// be the initially selected CA.
//
//-------------------------------------------------------------------------
typedef BOOL (WINAPI * PFN_CRYPTUI_SELECT_CA_FUNC)( PCCRYPTUI_CA_CONTEXT pCAContext, BOOL *pfInitialSelected, void *pvCallbackData);
//-------------------------------------------------------------------------
//
// CRYPTUI_SELECT_CA_STRUCT
//
// dwSize Required: Must be set to sizeof(CRYPTUI_SELECT_CA_STRUCT)
// hwndParent Optional: Parent of this dialog
// dwFlags Optional: Flags, Can be set to any combination of the following:
// CRYPTUI_DLG_SELECT_CA_FROM_NETWORK:
// All the available CAs from the network will be displayed
// CRYPTUI_DLG_SELECT_CA_USE_DN:
// Use the full DN (Distinguished Name) as the CA name.
// By default, CN (common name) is used.
// CRYPTUI_DLG_SELECT_CA_LOCAL_MACHINE_ENUMERATION:
// Display the CAs available to the local machine only.
// By Default, CAs available to the current user will be displayed
// wszTitle Optional: Title of the dialog
// wszDisplayString Optional: A string that will be displayed in the dialog that may (OPTIONAL)
// be used to inform the user what they are selecting a
// a certificate for. if it is not set a default string
// will be displayed. the defualt strings resourece is
// IDS_SELECT_CA_DISPLAY_DEFAULT
// cCAContext Optional: The count of additional CA contexts that will be displayed
// in the dialogs
// *rgCAContext Optioanl: The array of additional CA contexts that will be displayed
// in the dialogs
// pSelectCACallback Optional: a pointer to a PCCRYPTUI_CA_CONTEXT which is used to filter
// the certificate autorities which are displayed for selection
// pvCallbackData Optional: if pSelectCACallback is being used this value is passed
// back to the caller when the pSelectCACallback is made
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_SELECT_CA_STRUCT{ DWORD dwSize; // REQUIRED
HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR wszTitle; // OPTIONAL
LPCWSTR wszDisplayString; // OPTIONAL
DWORD cCAContext; // OPTIONAL
PCCRYPTUI_CA_CONTEXT *rgCAContext; // OPTIONAL
PFN_CRYPTUI_SELECT_CA_FUNC pSelectCACallback; // OPTIONAL
void *pvCallbackData; // OPTIONAL
}CRYPTUI_SELECT_CA_STRUCT, *PCRYPTUI_SELECT_CA_STRUCT;
typedef const CRYPTUI_SELECT_CA_STRUCT *PCCRYPTUI_SELECT_CA_STRUCT;
//--------------------------------------------------------------
//
// Parameters:
// pCryptUISelectCA IN Required
//
// the PCCRYPTUI_CA_CONTEXT that is returned must be released by calling
// CryptUIDlgFreeCAContext
// if NULL is returned and GetLastError() == 0 then the user dismissed the dialog by hitting the
// "cancel" button, otherwise GetLastError() will contain the last error.
//
//
//--------------------------------------------------------------
PCCRYPTUI_CA_CONTEXTWINAPICryptUIDlgSelectCA( IN PCCRYPTUI_SELECT_CA_STRUCT pCryptUISelectCA );
BOOLWINAPICryptUIDlgFreeCAContext( IN PCCRYPTUI_CA_CONTEXT pCAContext );
#if (0) //DSIE: 7/02/2002 moved to CryptUIAPI.h per consent degree.
//-------------------------------------------------------------------------
//
// CRYPTUI_CERT_MGR_STRUCT
//
// dwSize Required: Must be set to sizeof(CRYPTUI_CERT_MGR_STRUCT)
// hwndParent Optional: Parent of this dialog
// dwFlags Optional: Personal is the default initially selected
// tab.
// CRYPTUI_CERT_MGR_PUBLISHER_TAB may be set
// to select Trusted Publishers as the
// initially selected tab.
// CRYPTUI_CERT_MGR_SINGLE_TAB_FLAG may also
// be set to only display the Trusted
// Publishers tab.
// wszTitle Optional: Title of the dialog
// pszInitUsageOID Optional: The enhanced key usage object identifier (OID).
// Certificates with this OID will initially
// be shown as a default. User
// can then choose different OIDs.
// NULL means all certificates will be shown initially.
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_CERT_MGR_STRUCT{ DWORD dwSize; // REQUIRED
HWND hwndParent; // OPTIONAL
DWORD dwFlags; // OPTIONAL
LPCWSTR pwszTitle; // OPTIONAL
LPCSTR pszInitUsageOID; // OPTIONAL
}CRYPTUI_CERT_MGR_STRUCT, *PCRYPTUI_CERT_MGR_STRUCT;
typedef const CRYPTUI_CERT_MGR_STRUCT *PCCRYPTUI_CERT_MGR_STRUCT;
#define CRYPTUI_CERT_MGR_TAB_MASK 0x0000000F
#define CRYPTUI_CERT_MGR_PUBLISHER_TAB 0x00000004
#define CRYPTUI_CERT_MGR_SINGLE_TAB_FLAG 0x00008000
//--------------------------------------------------------------
//
// Parameters:
// pCryptUICertMgr IN Required
//
//
//--------------------------------------------------------------
BOOLWINAPICryptUIDlgCertMgr( IN PCCRYPTUI_CERT_MGR_STRUCT pCryptUICertMgr);#endif
/////////////////////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////////////////////////////////////////////////
//-----------------------------------------------------------------------
// The valid values for dwFlags for the CryptUIWiz APIs
//
//------------------------------------------------------------------------
#if (0) //DSIE: 7/02/2002 moved to CryptUIAPI.h per consent degree.
#define CRYPTUI_WIZ_NO_UI 0x0001
#endif
#define CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS 0x0002
#define CRYPTUI_WIZ_NO_UI_EXCEPT_CSP 0x0003
#define CRYPTUI_WIZ_ALLOW_ALL_TEMPLATES 0x0004
#define CRYPTUI_WIZ_ALLOW_ALL_CAS 0x0008
#define CRYPTUI_WIZ_CERT_REQUEST_REQUIRE_NEW_KEY 0x0040 // The enrollment API may not reuse an existing private key
// Valid only for CryptUIWizExport.
#define CRYPTUI_WIZ_EXPORT_PRIVATE_KEY 0x0100 // This will skip the Export Private Key page,
// and assume private key is to be exported.
#define CRYPTUI_WIZ_EXPORT_NO_DELETE_PRIVATE_KEY 0x0200 // This will disable the "Delete the priate key..."
// check box in the Export File Format page.
//CRYPTUI_WIZ_NO_INSTALL_ROOT is only valid for CryptUIWizCertRequest API
//the wizard will not install the issued certificate chain into the root store,
//instead, it will put the certificate chain into the CA store.
#define CRYPTUI_WIZ_NO_INSTALL_ROOT 0x0010
//CRYPTUI_WIZ_BUILDCTL_SKIP_DESTINATION only valid for CryptUIWizBuildCTL API.
//the wizard will skip the page which asks user to enter destination where the CTL will
//be stored.
#define CRYPTUI_WIZ_BUILDCTL_SKIP_DESTINATION 0x0004
//CRYPTUI_WIZ_BUILDCTL_SKIP_SIGNING only valid for CryptUIWizBuildCTL API.
//the wizard will skip the page which asks user to sign the CTL.
//the CTLContext returned by CryptUIWizBuildCTL will not be signed.
//Caller can then use CryptUIWizDigitalSign to sign the CTL.
#define CRYPTUI_WIZ_BUILDCTL_SKIP_SIGNING 0x0008
//CRYPTUI_WIZ_BUILDCTL_SKIP_PURPOSE only valid for CryptUIWizBuildCTL API.
//the wizard will skip the page which asks user for the purpose, validity,
//and list ID of the CTL.
#define CRYPTUI_WIZ_BUILDCTL_SKIP_PURPOSE 0x0010
#define CRYPTUI_WIZ_NO_ARCHIVE_RENEW_CERT 0x0020
#define CRYPTUI_WIZ_CREATE_ONLY 0x00010000
#define CRYPTUI_WIZ_SUBMIT_ONLY 0x00020000
#define CRYPTUI_WIZ_FREE_ONLY 0x00040000
#define CRYPTUI_WIZ_QUERY_ONLY 0x00080000
#define CRYPTUI_WIZ_NODS_MASK 0x000F0000
///-----------------------------------------------------------------------
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CERT
//
//------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_CERT_REQUEST_PVK_CERT{ DWORD dwSize; //Required: Set to the sizeof(CRYPTUI_WIZ_CERT_REQUEST_PVK_CERT)
PCCERT_CONTEXT pCertContext; //Required: Use the private key of the certificate context
// The certificate context
// has to have CERT_KEY_PROV_INFO_PROP_ID property
// and the private key has to exist
}CRYPTUI_WIZ_CERT_REQUEST_PVK_CERT, *PCRYPTUI_WIZ_CERT_REQUEST_PVK_CERT;
typedef const CRYPTUI_WIZ_CERT_REQUEST_PVK_CERT *PCCRYPTUI_WIZ_CERT_REQUEST_PVK_CERT;
///-----------------------------------------------------------------------
// CRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING
//
//------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING{ DWORD dwSize; //Required: Set to the sizeof(CRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING)
PCRYPT_KEY_PROV_INFO pKeyProvInfo; //Required: The information about the provider and the private key
// The optional CRYPT_KEY_PROV_PARAM fields in PCRYPT_KEY_PROV_INFO
// are ignored.
}CRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING, *PCRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING;
typedef const CRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING *PCCRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING;
///-----------------------------------------------------------------------
// CERT_REQUEST_PVK_NEW
//
//------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_CERT_REQUEST_PVK_NEW{ DWORD dwSize; //Required: Set to the sizeof(CRYPTUI_WIZ_CERT_REQUEST_PVK_NEW)
PCRYPT_KEY_PROV_INFO pKeyProvInfo; //Optional: The information about the provider and the private key
// NULL means use the default
// The optional CRYPT_KEY_PROV_PARAM fields in PCRYPT_KEY_PROV_INFO
// are ignored.
DWORD dwGenKeyFlags; //Optional: The flags for CryptGenKey
}CRYPTUI_WIZ_CERT_REQUEST_PVK_NEW, *PCRYPTUI_WIZ_CERT_REQUEST_PVK_NEW;
typedef const CRYPTUI_WIZ_CERT_REQUEST_PVK_NEW *PCCRYPTUI_WIZ_CERT_REQUEST_PVK_NEW;
///-----------------------------------------------------------------------
// CRYPTUI_WIZ_CERT_TYPE
//
//------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_CERT_TYPE{ DWORD dwSize; //Required: Set to the sizeof(CRYPTUI_WIZ_CERT_TYPE)
DWORD cCertType; //the count of rgwszCertType. cCertType should be 1.
LPWSTR *rgwszCertType; //the array of certificate type name
}CRYPTUI_WIZ_CERT_TYPE, *PCRYPTUI_WIZ_CERT_TYPE;
typedef const CRYPTUI_WIZ_CERT_TYPE *PCCRYPTUI_WIZ_CERT_TYPE;
//-----------------------------------------------------------------------
// dwPvkChoice
//-----------------------------------------------------------------------
#define CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_CERT 1
#define CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_EXISTING 2
#define CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_NEW 3
//-----------------------------------------------------------------------
// dwPurpose
//-----------------------------------------------------------------------
#define CRYPTUI_WIZ_CERT_ENROLL 0x00010000
#define CRYPTUI_WIZ_CERT_RENEW 0x00020000
//-----------------------------------------------------------------------
//
// valid flags for dwPostOption
//-----------------------------------------------------------------------
//post the requested certificate on the directory serivce
#define CRYPTUI_WIZ_CERT_REQUEST_POST_ON_DS 0x01
//post the requested certificate with the private key container.
#define CRYPTUI_WIZ_CERT_REQUEST_POST_ON_CSP 0x02
//-----------------------------------------------------------------------
//
// valid flags for dwCertChoice
//-----------------------------------------------------------------------
#define CRYPTUI_WIZ_CERT_REQUEST_KEY_USAGE 0x01
#define CRYPTUI_WIZ_CERT_REQUEST_CERT_TYPE 0x02
//-------------------------------------------------------------------------
//
//
// CRYPTUI_WIZ_CERT_REQUEST_INFO
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_CERT_REQUEST_INFO{ DWORD dwSize; //Required: Has to be set to sizeof(CRYPTUI_WIZ_CERT_REQUEST_INFO)
DWORD dwPurpose; //Required: If CRYPTUI_WIZ_CERT_ENROLL is set, a certificate will be enrolled,
// If CRYPTUI_WIZ_CERT_RENEW is set, a certificate will be renewed.
// CRYPTUI_WIZ_CERT_ENROLL and CRYPTUI_WIZ_CERT_RENEW can not be set
// at the same time
LPCWSTR pwszMachineName; //Optional: The machine name for which to enroll.
LPCWSTR pwszAccountName; //Optional: The account name(user or service) for which to enroll
//
// pwszMachineName pwszAccountName Meaning
//---------------------------------------------------
// NULL NULL Request for current account on the current machine
// "fooMachine" NULL Request for the machine named "fooMachine"
// NULL "fooUser" Request for the "fooUser" account on the current machine
// "fooMachine" "fooUser" Request for the "fooUser" accunt on the "fooMachine" machine
//
void *pAuthentication; //Reserved: authenticate info. Must be set to NULL.
LPCWSTR pCertRequestString; //Reserved: The additional request string. Must be set to NULL.
LPCWSTR pwszDesStore; //Optional: The desination store where to put
// the enrolled certificate. Default to "My" if the value is NULL
DWORD dwCertOpenStoreFlag; //Optional: The value passed to dwFlags of CertOpenStore for the
// destination store
// If this value is 0, we use CERT_SYSTEM_STORE_CURRENT_USER for
// an accout and CERT_SYSTEM_STORE_LOCAL_MACHINE for a machine
LPCSTR pszHashAlg; //Optional: The oid string of the hash algorithm of the certificate.
PCCERT_CONTEXT pRenewCertContext; //Required if CRYPTUI_WIZ_CERT_RENEW is set in dwPurpose
//Ignored otherwise and shoule be set to NULL.
DWORD dwPvkChoice; //Required: Specify the private key information
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_CERT
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_EXISTING
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_NEW
union //Required.
{ PCCRYPTUI_WIZ_CERT_REQUEST_PVK_CERT pPvkCert; PCCRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING pPvkExisting; PCCRYPTUI_WIZ_CERT_REQUEST_PVK_NEW pPvkNew; };
LPCWSTR pwszCALocation; //Required if dwCertChoice==CRYPTUI_WIZ_CERT_REQUEST_KEY_USAGE //Optional Otherwise
//Optional Otherwise
// The machine name of the Certiviate Authority (CA)
LPCWSTR pwszCAName; //Required if dwCertChoice==CRYPTUI_WIZ_CERT_REQUEST_KEY_USAGE
//Optional Otherwise
// The name of the Certificate Authority (CA)
DWORD dwPostOption; //Optional Can set to any combination of the following flag:
// CRYPTUI_WIZ_CERT_REQUEST_POST_ON_DS
//
DWORD dwCertChoice; //Optional if CRYPTUI_WIZ_CERT_ENROLL is set in dwPurpose
// and CRYPTUI_WIZ_NO_UI is not set
//Required if CRYPTUI_WIZ_CERT_ENROLL is set in dwPurpose
// and CRYPTUI_WIZ_NO_UI is set
//ignored otherwise and should be set to 0.
// Specify the type of the requested certificate
// it can be one of the following flag:
// CRYPTUI_WIZ_CERT_REQUEST_KEY_USAGE
// CRYPTUI_WIZ_CERT_REQUEST_CERT_TYPE
union { PCERT_ENHKEY_USAGE pKeyUsage; // Indicate the enhanced key usage OIDs for the requested certificate.
PCCRYPTUI_WIZ_CERT_TYPE pCertType; // Indicate the certificate type of the requested certificate
};
LPCWSTR pwszFriendlyName; //Optional if CRYPTUI_WIZ_CERT_ENROLL is set in dwPurpose
//Ignored otherwise and should be set to NULL.
// The friendly name of the certificate
LPCWSTR pwszDescription; //Optional if CRYPTUI_WIZ_CERT_ENROLL is set in dwPurpose
//Ignored otherwise and should be set to NULL.
// The description of the certificate
PCERT_EXTENSIONS pCertRequestExtensions; //Optional The extensions to add to the certificate request
LPWSTR pwszCertDNName; //Optional The certificate DN string
}CRYPTUI_WIZ_CERT_REQUEST_INFO, *PCRYPTUI_WIZ_CERT_REQUEST_INFO;
typedef const CRYPTUI_WIZ_CERT_REQUEST_INFO *PCCRYPTUI_WIZ_CERT_REQUEST_INFO;
//-------------------------------------------------------------------------
//
//
// CRYPTUI_WIZ_CERT_REQUEST_INFO:
// Used for three-stage no-DS enrollment API, exposed through
//
// CryptUIWizCreateCertRequestNoDS()
// CryptUIWizSubmitCertRequestNoDS()
// CryptUIWizFreeCertRequestNoDS()
//
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO { DWORD dwSize; //Required: Has to be set to sizeof(CRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO)
DWORD dwPurpose; //Required: If CRYPTUI_WIZ_CERT_ENROLL is set, a certificate will be enrolled,
// If CRYPTUI_WIZ_CERT_RENEW is set, a certificate will be renewed.
// CRYPTUI_WIZ_CERT_ENROLL and CRYPTUI_WIZ_CERT_RENEW can not be set
// at the same time
HCERTTYPE hCertType; //Required: A handle to the cert type to use in request creation.
BOOL fMachineContext; //Required: TRUE if running under machine context, FALSE otherwise.
DWORD dwCertOpenStoreFlag; //Optional: The value passed to dwFlags of CertOpenStore for the
// destination store.
// If this value is 0, we use CERT_SYSTEM_STORE_CURRENT_USER for
// an accout and CERT_SYSTEM_STORE_LOCAL_MACHINE for a machine
PCCERT_CONTEXT pRenewCertContext; //Required if CRYPTUI_WIZ_CERT_RENEW is set in dwPurpose
//Ignored otherwise and shoule be set to NULL.
DWORD dwPvkChoice; //Required: Specify the private key information
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_CERT
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_EXISTING
// CRYPTUI_WIZ_CERT_REQUEST_PVK_CHOICE_NEW
union //Required.
{ PCCRYPTUI_WIZ_CERT_REQUEST_PVK_CERT pPvkCert; PCCRYPTUI_WIZ_CERT_REQUEST_PVK_EXISTING pPvkExisting; PCCRYPTUI_WIZ_CERT_REQUEST_PVK_NEW pPvkNew; }; LPCWSTR pwszCALocation; //Required if dwCertChoice==CRYPTUI_WIZ_CERT_REQUEST_KEY_USAGE //Optional Otherwise
//Optional Otherwise
// The machine name of the Certiviate Authority (CA)
LPCWSTR pwszCAName; //Required if dwCertChoice==CRYPTUI_WIZ_CERT_REQUEST_KEY_USAGE
//Optional Otherwise
// The name of the Certificate Authority (CA)
} CRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO, *PCRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO;
typedef const CRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO * PCCRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO;
//-------------------------------------------------------------------------
//
//
// CRYPTUI_WIZ_CERT_REQUEST_INFO:
// Used to query the requests created by the no-DS enrollment API, exposed through
//
// CryptUIWizCreateCertRequestNoDS()
// CryptUIWizSubmitCertRequestNoDS()
// CryptUIWizFreeCertRequestNoDS()
// CryptUIWizQueryCertRequestNoDS()
//
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO { DWORD dwSize; // sizeof(CRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO)
DWORD dwStatus; // set of flags, see below
} CRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO, *PCRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO;
typedef const CRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO * PCCRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO;
//-----------------------------------------------------------------------
//
// possible flags for CRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO::dwStatus.
//
//-----------------------------------------------------------------------
#define CRYPTUI_WIZ_QUERY_CERT_REQUEST_STATUS_CREATE_REUSED_PRIVATE_KEY 0x00000001
//-----------------------------------------------------------------------
//
// possible status for pdwStatus
// Those status indicate the status value returned
// from the certificate authority (certificate server).
//-----------------------------------------------------------------------
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_SUCCEEDED 0
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_REQUEST_ERROR 1
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_REQUEST_DENIED 2
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_ISSUED_SEPARATELY 3
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_UNDER_SUBMISSION 4
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_UNKNOWN 5
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_CERT_ISSUED 6
#define CRYPTUI_WIZ_CERT_REQUEST_STATUS_CONNECTION_FAILED 7
//-----------------------------------------------------------------------
//
// CryptUIWizCertRequest
//
// Request a certificate via a wizard.
//
// dwFlags: IN Optional
// If CRYPTUI_WIZ_NO_UI is set in dwFlags, no UI will be shown.
// If CRYPTUI_WIZ_NO_INSTALL_ROOT is set in dwFlags, the wizard will not
// install the issued certificate chain into the root store,
// instead, it will put the certificate chain into the CA store.
//
// hwndParent: IN Optional
// The parent window for the UI. Ignored if CRYPTUI_WIZ_NO_UI is set in dwFlags
//
// pwszWizardTitle: IN Optional
// The title of the wizard. Ignored if CRYPTUI_WIZ_NO_UI is set in dwFlags
//
// pCertRequestInfo: IN Required
// A pointer to CRYPTUI_WIZ_CERT_REQUEST_INFO struct
//
// ppCertContext: Out Optional
// The issued certificate. The certificate is in a memory store for remote enrollment.
// The certificate is in a system cert store for local enrollment.
//
// Even the function return TRUE, it does not mean the certificate is issued. Use should
// check for the *pdwCAStatus. If the status is CRYPTUI_WIZ_CERT_REQUEST_STATUS_ISSUED_SEPERATELY
// of CRYPTUI_WIZ_CERT_REQUEST_STATUS_UNDER_SUBMISSION, *ppCertContext will be NULL.
// It is valid only if *pdwCAStatus==CRYPTUI_WIZ_CERT_REQUEST_STATUS_SUCCEEDED
//
// pdwCAStatus: Out Optional.
// The return status of the certificate authority cerver. The dwStatus can be one of
/// the following:
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_SUCCEEDED
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_REQUEST_ERROR
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_REQUEST_DENIED
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_ISSUED_SEPERATELY
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_UNDER_SUBMISSION
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizCertRequest( IN DWORD dwFlags, IN OPTIONAL HWND hwndParent, IN OPTIONAL LPCWSTR pwszWizardTitle, IN PCCRYPTUI_WIZ_CERT_REQUEST_INFO pCertRequestInfo, OUT OPTIONAL PCCERT_CONTEXT *ppCertContext, OUT OPTIONAL DWORD *pCAdwStatus);
//-----------------------------------------------------------------------
//
// CryptUIWizCreateCertRequestNoDS
//
// Create a certificate request using the supplied parameters.
//
// dwFlags: IN Required.
// CRYPTUI_WIZ_NO_UI: must be set.
// CRYPTUI_WIZ_NO_INSTALL_ROOT: if set, the issued certificate chain will not
// be installed into the root store. Instead,
// it will be installed in the CA store.
// pCreateCertRequestInfo: IN Required
// A pointer to CRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO struct
//
// phRequest: OUT Required.
// A HANDLE to the created request. This HANDLE can be passed
// to CryptUIWizSubmitCertRequestNoDS(), and, of course, should not
// be used for any other purpose.
//
// Returns: TRUE if successful, FALSE otherwise. Get extended error information
// using GetLastError().
//
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizCreateCertRequestNoDS(IN DWORD dwFlags, IN HWND hwndParent, IN PCCRYPTUI_WIZ_CREATE_CERT_REQUEST_INFO pCreateCertRequestInfo, OUT HANDLE *phRequest);
//-----------------------------------------------------------------------
//
// CryptUIWizSubmitCertRequestNoDS
//
// Request a certificate using a request created by CryptUIWizCreateCertRequestNoDS().
//
// hRequest: IN Required.
// A HANDLE to the request to submit. Must have been created through
// CryptUIWizCreateCertRequest().
//
// ppCertContext: OUT Required.
// The issued certificate. The certificate is in a memory store for remote enrollment.
// The certificate is in a system cert store for local enrollment.
//
// Even the function return TRUE, it does not mean the certificate is issued. Use should
// check for the *pdwCAStatus. If the status is CRYPTUI_WIZ_CERT_REQUEST_STATUS_ISSUED_SEPERATELY
// of CRYPTUI_WIZ_CERT_REQUEST_STATUS_UNDER_SUBMISSION, *ppCertContext will be NULL.
// It is valid only if *pdwCAStatus==CRYPTUI_WIZ_CERT_REQUEST_STATUS_SUCCEEDED
//
// pdwCAStatus: Out Optional.
// The return status of the certificate authority cerver. The dwStatus can be one of
/// the following:
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_SUCCEEDED
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_REQUEST_ERROR
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_REQUEST_DENIED
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_ISSUED_SEPERATELY
// CRYPTUI_WIZ_CERT_REQUEST_STATUS_UNDER_SUBMISSION
//
// Returns: TRUE if the procedure executed without an error, FALSE otherwise. Check
// pdwStatus to verify that the certificate was issued. Get extended
// error information using GetLastError().
//
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizSubmitCertRequestNoDS(IN HANDLE hRequest, IN HWND hwndParent, IN LPCWSTR pwszCAName, IN LPCWSTR pwszCALocation, OUT DWORD *pdwStatus, OUT PCCERT_CONTEXT *ppCertContext // Optional
);
//------------------------------------------------------------------------
//
// CryptUIWizFreeCertRequestNoDS
//
// Frees a certificate request created by CryptUIWizCreateCertRequestNoDS().
//
// hRequest: IN Required.
// A HANDLE to the request to be freed.
//
//------------------------------------------------------------------------
voidWINAPICryptUIWizFreeCertRequestNoDS(IN HANDLE hRequest);
//------------------------------------------------------------------------
//
// CryptUIWizQueryCertRequestNoDS
//
// Queries status information about a created request.
//
// hRequest: IN Required.
// A HANDLE to the request to be freed.
//
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizQueryCertRequestNoDS(IN HANDLE hRequest, OUT CRYPTUI_WIZ_QUERY_CERT_REQUEST_INFO *pQueryInfo);
//-------------------------------------------------------------------------
//
// Valid values for dwSubjectChoice in IMPORT_SUBJECT_INFO
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_IMPORT_SUBJECT_FILE 1
#define CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT 2
#define CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT 3
#define CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT 4
#define CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE 5
//-------------------------------------------------------------------------
//
// Struct to define the subject CertImportWizard
//
// CRYPTUI_WIZ_IMPORT_SUBJECT_INFO
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO{ DWORD dwSize; //Required: should be set to sizeof(IMPORT_SUBJECT_INFO)
DWORD dwSubjectChoice; //Required: indicate the type of the subject:
// If can one of the following:
// CRYPTUI_WIZ_IMPORT_SUBJECT_FILE
// CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT
// CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT
// CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT
// CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE
union { LPCWSTR pwszFileName; PCCERT_CONTEXT pCertContext; PCCTL_CONTEXT pCTLContext; PCCRL_CONTEXT pCRLContext; HCERTSTORE hCertStore; };
DWORD dwFlags; //Required if pwszFileName contains a PFX BLOB.
//Ignored otherwise
//This is the same flag for PFXImportCertStore
LPCWSTR pwszPassword; //Required if pwszFileName contains a PFX BLOB.
//ignored otherwise
}CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;
typedef const CRYPTUI_WIZ_IMPORT_SRC_INFO *PCCRYPTUI_WIZ_IMPORT_SRC_INFO;
//-----------------------------------------------------------------------
//
// Valid flags for dwFlags in CryptUIWizImport
//
//-----------------------------------------------------------------------
//if this flag is set in dwFlags, user will not be allowed to change
//the hDesCertStore in the wizard page
#define CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE 0x00010000
//Allow importing certificate
#define CRYPTUI_WIZ_IMPORT_ALLOW_CERT 0x00020000
//Allow importing certificate revocation list
#define CRYPTUI_WIZ_IMPORT_ALLOW_CRL 0x00040000
//Allow importing certificate trust list
#define CRYPTUI_WIZ_IMPORT_ALLOW_CTL 0x00080000
//import contents to local machine (currently only applicable for PFX imports)
#define CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE 0x00100000
//import contents to current user (currently only applicable for PFX imports)
#define CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER 0x00200000
//if the hDesCertStore is a remote store handle, this flag should be set
#define CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE 0x00400000
//-----------------------------------------------------------------------
//
// CryptUIWizImport
//
// The import wizard to import public key related files to a certificate
// store
//
// dwFlags can be set to any combination of the following flags:
// CRYPTUI_WIZ_NO_UI No UI will be shown. Otherwise, User will be
// prompted by a wizard.
// CRYPTUI_WIZ_IMPORT_ALLOW_CERT Allow importing certificate
// CRYPTUI_WIZ_IMPORT_ALLOW_CRL Allow importing CRL(certificate revocation list)
// CRYPTUI_WIZ_IMPORT_ALLOW_CTL Allow importing CTL(certificate trust list)
// CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE user will not be allowed to change
// the hDesCertStore in the wizard page
// CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE the contents should be imported to local machine
// (currently only applicable for PFX imports)
// CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER the contents should be imported to current user
// (currently only applicable for PFX imports)
//
// Please notice that if neither of following three flags is in dwFlags, default to is
// allow everything.
// CRYPTUI_WIZ_IMPORT_ALLOW_CERT
// CRYPTUI_WIZ_IMPORT_ALLOW_CRL
// CRYPTUI_WIZ_IMPORT_ALLOW_CTL
//
// Also, note that the CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE and CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER
// flags are used force the content of a pfx blob into either local machine or current user.
// If neither of these flags are used and hDesCertStore is NULL then:
// 1) The private key in the pfx blob will be forced to be imported into current user.
// 2) If CRYPTUI_WIZ_NO_UI is NOT set, the wizard will prompt the user to select a certificate
// store from the current user stores.
//
//
//
// If CRYPTUI_WIZ_NO_UI is set in dwFlags:
// hwndParent: Ignored
// pwszWizardTitle: Ignored
// pImportSubject: IN Required: The subject to import.
// hDesCertStore: IN Optional: The destination certficate store
//
// If CRYPTUI_WIZ_NO_UI is not set in dwFlags:
// hwndPrarent: IN Optional: The parent window for the wizard
// pwszWizardTitle: IN Optional: The title of the wizard
// If NULL, the default will be IDS_IMPORT_WIZARD_TITLE
// pImportSubject: IN Optional: The file name to import.
// If NULL, the wizard will prompt user to enter the file name
// hDesCertStore: IN Optional: The destination certificate store where the file wil be
// imported to. The store should be opened with
// flag CERT_STORE_SET_LOCALIZED_NAME_FLAG. If NULL, the wizard will prompt user to select
// a certificate store.
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizImport( DWORD dwFlags, HWND hwndParent, LPCWSTR pwszWizardTitle, PCCRYPTUI_WIZ_IMPORT_SRC_INFO pImportSrc, HCERTSTORE hDestCertStore);
//-------------------------------------------------------------------------
//
// Struct to define the information needed to build a new CTL
//
// CRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO
//
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO{ DWORD dwSize; //Required: should be set to sizeof(CRYPTUI_WIZ_BUILDCTL_NEW_CTL)
PCERT_ENHKEY_USAGE pSubjectUsage; //Optioanl: The purpose of the CTL
LPWSTR pwszListIdentifier; //Optional: The string to identify the CTL
LPCSTR pszSubjectAlgorithm; //Optional: The hashing algorithm.
// Currently, only SHA1 or MD5 hashing is supported
HCERTSTORE hCertStore; //Optional: The certificate in the CTL. Only the certificates
// with the enhanced key usage specified by pSubjectUsage
// will be included in the CTL
FILETIME NextUpdate; //Optional: The next update time of the CTL. If the value
// is more than 99 month from the current system time,
// the value will be ignored.
LPWSTR pwszFriendlyName; //Optional: The friendly name of the CTL
LPWSTR pwszDescription; //Optional: The description of the CTL
}CRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO, *PCRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO;
typedef const CRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO *PCCRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO;
//-------------------------------------------------------------------------
//
// Valid values for dwSourceChoice for CRYPTUI_WIZ_BUILDCTL_SRC_INFO
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_BUILDCTL_SRC_EXISTING_CTL 1
#define CRYPTUI_WIZ_BUILDCTL_SRC_NEW_CTL 2
//-------------------------------------------------------------------------
//
// Struct to define the source of certBuildCTL wizard
//
// CRYPTUI_WIZ_BUILDCTL_SRC_INFO
//
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_BUILDCTL_SRC_INFO{ DWORD dwSize; //Required: should be set to sizeof(CRYPTUI_WIZ_BUILDCTL_SRC_INFO)
DWORD dwSourceChoice; //Required: indicate the source from which to build the CTL
// if can be one of the following:
// CRYPTUI_WIZ_BUILDCTL_SRC_EXISTING_CTL
// CRYPTUI_WIZ_BUILDCTL_SRC_NEW_CTL
union { PCCTL_CONTEXT pCTLContext; //Required if dwSourceChoice == CRYPTUI_WIZ_BUILDCTL_SRC_EXISTING_CTL
// An existing CTL based on which a new CTL is to be built
PCCRYPTUI_WIZ_BUILDCTL_NEW_CTL_INFO pNewCTLInfo; //Required if dwSourceChoise == CRYPTUI_WIZ_BUILDCTL_SRC_NEW_CTL
};}CRYPTUI_WIZ_BUILDCTL_SRC_INFO, *PCRYPTUI_WIZ_BUILDCTL_SRC_INFO;
typedef const CRYPTUI_WIZ_BUILDCTL_SRC_INFO *PCCRYPTUI_WIZ_BUILDCTL_SRC_INFO;
//-------------------------------------------------------------------------
//
// Valid values for dwDestinationChoice for CRYPTUI_WIZ_BUILDCTL_DEST_INFO
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_BUILDCTL_DEST_CERT_STORE 1
#define CRYPTUI_WIZ_BUILDCTL_DEST_FILE 2
//-------------------------------------------------------------------------
//
// Struct to define the desination of certBuildCTL wizard
//
// CRYPTUI_WIZ_BUILDCTL_DEST_INFO
//
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_BUILDCTL_DEST_INFO{ DWORD dwSize; //Required: should be set to sizeof(CRYPTUI_WIZ_BUILDCTL_DEST_INFO)
DWORD dwDestinationChoice; //Required: indicate the type of the desination:
// If can one of the following:
// CRYPTUI_WIZ_BUILDCTL_DEST_CERT_STORE
// CRYPTUI_WIZ_BUILDCTL_DEST_FILE
union { LPCWSTR pwszFileName; HCERTSTORE hCertStore; };
}CRYPTUI_WIZ_BUILDCTL_DEST_INFO, *PCRYPTUI_WIZ_BUILDCTL_DEST_INFO;
typedef const CRYPTUI_WIZ_BUILDCTL_DEST_INFO *PCCRYPTUI_WIZ_BUILDCTL_DEST_INFO;
//-----------------------------------------------------------------------
//
// CryptUIWizBuildCTL
//
// Build a new CTL or modify an existing CTL. The UI for wizard will
// always show in this case
//
//
// dwFlags: IN Optional: Can be set to the any combination of the following:
// CRYPTUI_WIZ_BUILDCTL_SKIP_DESTINATION.
// CRYPTUI_WIZ_BUILDCTL_SKIP_SIGNING
// CRYPTUI_WIZ_BUILDCTL_SKIP_PURPOSE
// hwndParnet: IN Optional: The parent window handle
// pwszWizardTitle: IN Optional: The title of the wizard
// If NULL, the default will be IDS_BUILDCTL_WIZARD_TITLE
// pBuildCTLSrc: IN Optional: The source from which the CTL will be built
// pBuildCTLDest: IN Optional: The desination where the newly
// built CTL will be stored
// ppCTLContext: OUT Optaionl: The newly build CTL
//
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizBuildCTL( IN DWORD dwFlags, IN OPTIONAL HWND hwndParent, IN OPTIONAL LPCWSTR pwszWizardTitle, IN OPTIONAL PCCRYPTUI_WIZ_BUILDCTL_SRC_INFO pBuildCTLSrc, IN OPTIONAL PCCRYPTUI_WIZ_BUILDCTL_DEST_INFO pBuildCTLDest, OUT OPTIONAL PCCTL_CONTEXT *ppCTLContext);
//-------------------------------------------------------------------------
//
// Valid values for dwSubjectChoice in CRYPTUI_WIZ_EXPORT_INFO
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_EXPORT_CERT_CONTEXT 1
#define CRYPTUI_WIZ_EXPORT_CTL_CONTEXT 2
#define CRYPTUI_WIZ_EXPORT_CRL_CONTEXT 3
#define CRYPTUI_WIZ_EXPORT_CERT_STORE 4
#define CRYPTUI_WIZ_EXPORT_CERT_STORE_CERTIFICATES_ONLY 5
//-------------------------------------------------------------------------
//
// Struct to define the object to be exported and where to export it to
//
// CRYPTUI_WIZ_EXPORT_SUBJECT_INFO
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_EXPORT_INFO{ DWORD dwSize; //Required: should be set to sizeof(CRYPTUI_WIZ_EXPORT_INFO)
LPCWSTR pwszExportFileName; //Required if the CRYPTUI_WIZ_NO_UI flag is set, Optional otherwise.
//The fully qualified file name to export to, if this is
//non-NULL and the CRYPTUI_WIZ_NO_UI flag is NOT set, then it is
//displayed to the user as the default file name
DWORD dwSubjectChoice; //Required: indicate the type of the subject:
// If can one of the following:
// CRYPTUI_WIZ_EXPORT_CERT_CONTEXT
// CRYPTUI_WIZ_EXPORT_CTL_CONTEXT
// CRYPTUI_WIZ_EXPORT_CRL_CONTEXT
// CRYPTUI_WIZ_EXPORT_CERT_STORE
// CRYPTUI_WIZ_EXPORT_CERT_STORE_CERTIFICATES_ONLY
union { PCCERT_CONTEXT pCertContext; PCCTL_CONTEXT pCTLContext; PCCRL_CONTEXT pCRLContext; HCERTSTORE hCertStore; };
DWORD cStores; // Optional: count of extra stores to search for the certs in the
// trust chain if the chain is being exported with a cert.
// this is ignored if dwSubjectChoice is anything other
// than CRYPTUI_WIZ_EXPORT_CERT_CONTEXT
HCERTSTORE * rghStores; // Optional: array of extra stores to search for the certs in the
// trust chain if the chain is being exported with a cert.
// this is ignored if dwSubjectChoice is anything other
// than CRYPTUI_WIZ_EXPORT_CERT_CONTEXT
}CRYPTUI_WIZ_EXPORT_INFO, *PCRYPTUI_WIZ_EXPORT_INFO;
typedef const CRYPTUI_WIZ_EXPORT_INFO *PCCRYPTUI_WIZ_EXPORT_INFO;
//-------------------------------------------------------------------------
//
// Valid values for dwExportFormat in CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_EXPORT_FORMAT_DER 1
#define CRYPTUI_WIZ_EXPORT_FORMAT_PFX 2
#define CRYPTUI_WIZ_EXPORT_FORMAT_PKCS7 3
#define CRYPTUI_WIZ_EXPORT_FORMAT_BASE64 4
#define CRYPTUI_WIZ_EXPORT_FORMAT_SERIALIZED_CERT_STORE 5 // NOTE: not currently supported!!
//-------------------------------------------------------------------------
//
// Struct to define the information needed to export a CERT_CONTEXT
//
// CRYPTUI_WIZ_EXPORT_NOUI_INFO
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO{ DWORD dwSize; //Required: should be set to sizeof(CRYPTUI_WIZ_EXPORT_NOUI_INFO)
DWORD dwExportFormat; //Required:
// It can be one of the following:
// CRYPTUI_WIZ_EXPORT_FORMAT_DER
// CRYPTUI_WIZ_EXPORT_FORMAT_PFX
// CRYPTUI_WIZ_EXPORT_FORMAT_PKCS7
// CRYPTUI_WIZ_EXPORT_FORMAT_SERIALIZED_CERT_STORE
BOOL fExportChain; //Required
BOOL fExportPrivateKeys; //Required
LPCWSTR pwszPassword; //Required if the fExportPrivateKeys boolean is TRUE, otherwise,
//it is ignored
BOOL fStrongEncryption; //Required if dwExportFormat is CRYPTUI_WIZ_EXPORT_FORMAT_PFX
//Note that if this flag is TRUE then the PFX blob produced is
//NOT compatible with IE4.
}CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO, *PCRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO;
typedef const CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO *PCCRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO;
//-----------------------------------------------------------------------
//
// CryptUIWizExport
//
// The export wizard to export public key related objects to a file
//
// If dwFlags is set to CRYPTUI_WIZ_NO_UI, no UI will be shown. Otherwise,
// User will be prompted for input through a wizard.
//
// If CRYPTUI_WIZ_NO_UI is set in dwFlags:
// hwndParent: Ignored
// pwszWizardTitle: Ignored
// pExportInfo: IN Required: The subject to export.
// pvoid: IN Required: Contains information about how to do the export based on what
// is being exported
//
// dwSubjectChoice INPUT TYPE
// -------------------------------------------------------------------------
// CRYPTUI_WIZ_EXPORT_CERT_CONTEXT PCCRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO
// CRYPTUI_WIZ_EXPORT_CTL_CONTEXT NULL
// CRYPTUI_WIZ_EXPORT_CRL_CONTEXT NULL
// CRYPTUI_WIZ_EXPORT_CERT_STORE NULL
//
// If CRYPTUI_WIZ_NO_UI is not set in dwFlags:
// hwndPrarent: IN Optional: The parent window for the wizard
// pwszWizardTitle: IN Optional: The title of the wizard
// If NULL, the default will be IDS_EXPORT_WIZARD_TITLE
// pExportInfo: IN Required: The subject to export.
// pvoid: IN Optional: Contains information about how to do the export based on what
// is being exported. See above table for values, if this is non-NULL
// the values are displayed to the user as the default choices.
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizExport( DWORD dwFlags, HWND hwndParent, LPCWSTR pwszWizardTitle, PCCRYPTUI_WIZ_EXPORT_INFO pExportInfo, void *pvoid);
#if (0) //DSIE: 7/02/2002 moved to CryptUIAPI.h per consent degree.
//-------------------------------------------------------------------------
//valid values for dwSubjectChoice in CRYPTUI_WIZ_DIGITAL_SIGN_INFO struct
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE 0x01
#define CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB 0x02
//-------------------------------------------------------------------------
//valid values for dwSigningCertChoice in CRYPTUI_WIZ_DIGITAL_SIGN_INFO struct
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_DIGITAL_SIGN_CERT 0x01
#define CRYPTUI_WIZ_DIGITAL_SIGN_STORE 0x02
#define CRYPTUI_WIZ_DIGITAL_SIGN_PVK 0x03
//-------------------------------------------------------------------------
//valid values for dwAddtionalCertChoice in CRYPTUI_WIZ_DIGITAL_SIGN_INFO struct
//-------------------------------------------------------------------------
//include the entire certificate trust chain in the signature
#define CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN 0x00000001
//include the entilre certificate trust chain, with the exception of the root
//certificate, in the signature
#define CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT 0x00000002
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO
//
// dwSize IN Required: should be set to sizeof(CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO)
// pGuidSubject IN Required: Idenfity the sip functions to load
// cbBlob IN Required: the size of BLOB, in bytes
// pbBlob IN Required: the pointer to the BLOB
// pwszDispalyName IN Optional: the display name of the BLOB to sign.
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO{ DWORD dwSize; GUID *pGuidSubject; DWORD cbBlob; BYTE *pbBlob; LPCWSTR pwszDisplayName;}CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO;
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO
//
// dwSize IN Required: should be set to sizeof(CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO)
// cCertStore IN Required: The acount of certificate store array that includes potentical sining certs
// rghCertStore IN Required: The certificate store array that includes potential signing certs
// pFilterCallback IN Optional: The filter call back function for display the certificate
// pvCallbackData IN Optional: The call back data
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO{ DWORD dwSize; DWORD cCertStore; HCERTSTORE *rghCertStore; PFNCFILTERPROC pFilterCallback; void * pvCallbackData;}CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO;
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO
//
// dwSize IN Required: should be set to sizeof(CRYPT_WIZ_DIGITAL_SIGN_PVK_FILE_INFO)
// pwszPvkFileName IN Required: the PVK file name
// pwszProvName IN Required: the provider name
// dwProvType IN Required: the provider type
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO{ DWORD dwSize; LPWSTR pwszPvkFileName; LPWSTR pwszProvName; DWORD dwProvType;}CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO;
//-------------------------------------------------------------------------
//
// valid values for dwPvkChoice in CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO struct
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE 0x01
#define CRYPTUI_WIZ_DIGITAL_SIGN_PVK_PROV 0x02
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO
//
// dwSize IN Required: should be set to sizeof(CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO)
// pwszSigningCertFileName IN Required: the file name that contains the signing cert(s)
// dwPvkChoice IN Required: Indicate the private key type:
// It can be one of the following:
// CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE
// CRYPTUI_WIZ_DIGITAL_SIGN_PVK_PROV
// pPvkFileInfo IN Required if dwPvkChoice == CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE
// pPvkProvInfo IN Required if dwPvkContainer== CRYPTUI_WIZ_DIGITAL_SIGN_PVK_PROV
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO{ DWORD dwSize; LPWSTR pwszSigningCertFileName; DWORD dwPvkChoice; union { PCCRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO pPvkFileInfo; PCRYPT_KEY_PROV_INFO pPvkProvInfo; };
}CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO;
//-------------------------------------------------------------------------
//
// valid values for dwAttrFlags in CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO struct
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_DIGITAL_SIGN_COMMERCIAL 0x0001
#define CRYPTUI_WIZ_DIGITAL_SIGN_INDIVIDUAL 0x0002
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO
//
// dwSize IN Required: should be set to sizeof(CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO)
// dwAttrFlags IN Required: Flag to indicate signing options.
// It can be one of the following:
// CRYPTUI_WIZ_DIGITAL_SIGN_COMMERCIAL
// CRYPTUI_WIZ_DIGITAL_SIGN_INDIVIDUAL
// pwszDescription IN Optional: The description of the signing subject
// pwszMoreInfoLocation IN Optional: the localtion to get more information about file
// this information will be shown upon download time
// pszHashAlg IN Optional: the hashing algorithm for the signature
// NULL means using SHA1 hashing algorithm
// pwszSigningCertDisplayString IN Optional: The display string to be displayed on the
// signing certificate wizard page. The string should
// prompt user to select a certificate for a particular purpose
// hAddtionalCertStores IN Optional: the addtional cert store to add to the signature
// psAuthenticated IN Optional: user supplied authenticated attributes added to the signature
// psUnauthenticated IN Optional: user supplied unauthenticated attributes added to the signature
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO{ DWORD dwSize; DWORD dwAttrFlags; LPCWSTR pwszDescription; LPCWSTR pwszMoreInfoLocation; LPCSTR pszHashAlg; LPCWSTR pwszSigningCertDisplayString; HCERTSTORE hAdditionalCertStore; PCRYPT_ATTRIBUTES psAuthenticated; PCRYPT_ATTRIBUTES psUnauthenticated; }CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO;//-------------------------------------------------------------------------
//
//
// CRYPTUI_WIZ_DIGITAL_SIGN_INFO
//
// dwSize IN Required: Has to be set to sizeof(CRYPTUI_WIZ_DIGITAL_SIGN_INFO)
// dwSubjectChoice IN Required if CRYPTUI_WIZ_NO_UI is set in dwFlags of the CryptUIWizDigitalSigning, :
// Optional if CRYPTUI_WIZ_NO_UI is not set in dwFlags of the CryptUIWizDigitalSigning
// Indicate whether to sign a file or to sign a memory BLOB.
// 0 means promting user for the file to sign
// It can be one of the following:
// CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE
// CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB
//
//
//pwszFileName IN Required if dwSubjectChoice==CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE
//pSignBlobInfo IN Required if dwSubhectChoice==CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB
//
//dwSigningCertChoice IN Optional: Indicate the signing certificate.
// 0 means using the certificates in "My" store"
// It can be one of the following choices:
// CRYPTUI_WIZ_DIGITAL_SIGN_CERT
// CRYPTUI_WIZ_DIGITAL_SIGN_STORE
// CRYPTUI_WIZ_DIGITAL_SIGN_PVK
// If CRYPTUI_WIZ_NO_UI is set in dwFlags of the CryptUIWizDigitalSigning,
// dwSigningCertChoice has to be CRYPTUI_WIZ_DIGITAL_SIGN_CERT or
// CRYPTUI_WIZ_DIGITAL_SIGN_PVK
//
//pSigningCertContext IN Required if dwSigningCertChoice==CRYPTUI_WIZ_DIGITAL_SIGN_CERT
//pSigningCertStore IN Required if dwSigningCertChoice==CRYPTUI_WIZ_DIGITAL_SIGN_STORE
//pSigningCertPvkInfo IN Required if dwSigningCertChoise==CRYPTUI_WIZ_DIGITAL_SIGN_PVK
//
//pwszTimestampURL IN Optional: The timestamp URL address
//
//dwAdditionalCertChoice IN Optional: Indicate additional certificates to be included in the signature. //
// 0 means no addtional certificates will be added
// The following flags are mutually exclusive.
// Only one of them can be set:
// CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN
// CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT
//
//
//pSignExtInfo IN Optional: The extended information for signing
//
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO{ DWORD dwSize; DWORD dwSubjectChoice; union { LPCWSTR pwszFileName; PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo; };
DWORD dwSigningCertChoice; union { PCCERT_CONTEXT pSigningCertContext; PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO pSigningCertStore; PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo; };
LPCWSTR pwszTimestampURL; DWORD dwAdditionalCertChoice; PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
}CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO;
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT
//
// dwSize set to sizeof(CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT)
// cbBlob the size of pbBlob. In bytes
// pbBlob the signed BLOB
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT{ DWORD dwSize; DWORD cbBlob; BYTE *pbBlob; }CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT, *PCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT;
typedef const CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT;
//-----------------------------------------------------------------------
//
// CryptUIWizDigitalSign
//
// The wizard to digitally sign a document or a BLOB.
//
// If CRYPTUI_WIZ_NO_UI is set in dwFlags, no UI will be shown. Otherwise,
// User will be prompted for input through a wizard.
//
// dwFlags: IN Required:
// hwndParnet: IN Optional: The parent window handle
// pwszWizardTitle: IN Optional: The title of the wizard
// If NULL, the default will be IDS_DIGITAL_SIGN_WIZARD_TITLE
// pDigitalSignInfo: IN Required: The information about the signing process
// ppSignContext OUT Optional: The context pointer points to the signed BLOB
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizDigitalSign( IN DWORD dwFlags, IN OPTIONAL HWND hwndParent, IN OPTIONAL LPCWSTR pwszWizardTitle, IN PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO pDigitalSignInfo, OUT OPTIONAL PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext);
BOOLWINAPICryptUIWizFreeDigitalSignContext( IN PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT pSignContext);#endif
//-------------------------------------------------------------------------
//valid values for dwPageChoice in CRYPTUI_WIZ_SIGN_GET_PAGE_INFO
//-------------------------------------------------------------------------
#define CRYPTUI_WIZ_DIGITAL_SIGN_TYPICAL_SIGNING_OPTION_PAGES 0x0001
#define CRYPTUI_WIZ_DIGITAL_SIGN_MINIMAL_SIGNING_OPTION_PAGES 0x0002
#define CRYPTUI_WIZ_DIGITAL_SIGN_CUSTOM_SIGNING_OPTION_PAGES 0x0004
#define CRYPTUI_WIZ_DIGITAL_SIGN_ALL_SIGNING_OPTION_PAGES 0x0008
#define CRYPTUI_WIZ_DIGITAL_SIGN_WELCOME_PAGE 0x0100
#define CRYPTUI_WIZ_DIGITAL_SIGN_FILE_NAME_PAGE 0x0200
#define CRYPTUI_WIZ_DIGITAL_SIGN_CONFIRMATION_PAGE 0x0400
//-------------------------------------------------------------------------
//
// CRYPTUI_WIZ_SIGN_GET_PAGE_INFO
//
// dwSize IN Required: should be set to sizeof(CRYPTUI_WIZ_SIGN_GET_PAGE_INFO)
// dwPageChoice: IN Required: It should one of the following:
// CRYPTUI_WIZ_DIGITAL_SIGN_ALL_SIGNING_OPTION_PAGES
// CRYPTUI_WIZ_DIGITAL_SIGN_TYPICAL_SIGNING_OPTION_PAGES
// CRYPTUI_WIZ_DIGITAL_SIGN_MINIMAL_SIGNING_OPTION_PAGES
// CRYPTUI_WIZ_DIGITAL_SIGN_CUSTOM_SIGNING_OPTION_PAGES
// It can also be ORed with any of the following:
// CRYPTUI_WIZ_DIGITAL_SIGN_WELCOME_PAGE
// CRYPTUI_WIZ_DIGITAL_SIGN_CONFIRMATION_PAGE
// CRYPTUI_WIZ_DIGITAL_SIGN_FILE_NAME_PAGE
// If user tries to sign a BLOB, CRYPTUI_WIZ_DIGITAL_SIGN_FILE_NAME_PAGE
// should not be set
// dwFlags; IN Optional: Flags and has to be set to 0
// hwndParent IN Optional: The parent window of the dialogue
// pwszPageTitle IN Optional: The title for the pages and the message boxes.
// pDigitalSignInfo IN Optional: the addtional information for signing
// pPropPageCallback IN Optional: this callback will be called when each page that is
// returned in the CryptUIGetViewSignaturesPages call
// is about to be created or destroyed. if this is NULL no
// callback is made.
// pvCallbackData IN Optional: this is uniterpreted data that is passed back when the
// when pPropPageCallback is made
// fResult OUT: The result of signing
// dwError OUT: The value of GetLastError() if fResult is FALSE
// pSignContext OUT: The context pointer to the signed BLOB. User needs to free
// the blob by CryptUIWizDigitalSignFreeContext
// dwReserved Reserved: The private data used by the signing process.
// must be set to NULL
// pvSignReserved Reserved: The private data used by the signing process
// must be set to NULL
//-------------------------------------------------------------------------
typedef struct _CRYPTUI_WIZ_GET_SIGN_PAGE_INFO{ DWORD dwSize; DWORD dwPageChoice; DWORD dwFlags; HWND hwndParent; LPWSTR pwszPageTitle; PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO pDigitalSignInfo; PFNCPROPPAGECALLBACK pPropPageCallback; void * pvCallbackData; BOOL fResult; DWORD dwError; PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT pSignContext; DWORD dwReserved; void *pvSignReserved;}CRYPTUI_WIZ_GET_SIGN_PAGE_INFO, *PCRYPTUI_WIZ_GET_SIGN_PAGE_INFO;
typedef const CRYPTUI_WIZ_GET_SIGN_PAGE_INFO *PCCRYPTUI_WIZ_GET_SIGN_PAGE_INFO;
//-----------------------------------------------------------------------
//
// CryptUIWizGetDigitalSignPages
//
// Get specific wizard pages from the CryptUIWizDigitalSign wizard.
// Application can include the pages to other wizards. The pages will
// gather user inputs throught the new "Parent" wizard.
// After user clicks the finish buttion, signing process will start the signing
// and return the result in fResult and dwError field of CRYPTUI_WIZ_SIGN_GET_PAGE_INFO
// struct. If not enough information can be gathered through the wizard pages,
// user should supply addtional information in pSignGetPageInfo.
//
//
// pSignGetPageInfo IN Required: The struct that user allocate. It can be used
// to supply additinal information which is not gathered
// from the selected wizard pages
// prghPropPages, OUT Required: The wizard pages returned. Please
// notice the pszTitle of the struct is set to NULL
// pcPropPages OUT Required: The number of wizard pages returned
//------------------------------------------------------------------------
BOOLWINAPICryptUIWizGetDigitalSignPages( IN PCRYPTUI_WIZ_GET_SIGN_PAGE_INFO pSignGetPageInfo, OUT PROPSHEETPAGEW **prghPropPages, OUT DWORD *pcPropPages);
BOOLWINAPICryptUIWizFreeDigitalSignPages( IN PROPSHEETPAGEW *rghPropPages, IN DWORD cPropPages );
DWORDWINAPII_CryptUIProtect( IN PVOID pvReserved1, IN PVOID pvReserved2, IN DWORD dwReserved3, IN PVOID *pvReserved4, IN BOOL fReserved5, IN PVOID pvReserved6 );
DWORDWINAPII_CryptUIProtectFailure( IN PVOID pvReserved1, IN DWORD dwReserved2, IN PVOID *pvReserved3);
#include <poppack.h>
#ifdef __cplusplus
} // Balance extern "C" above
#endif
#endif // _CRYPTUI_H_
|
