Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

2530 lines
133 KiB

//+---------------------------------------------------------------------------
//
// 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
//
BOOL
WINAPI
CryptUIDlgViewCertificateW(
IN PCCRYPTUI_VIEWCERTIFICATE_STRUCTW pCertViewInfo,
OUT BOOL *pfPropertiesChanged // OPTIONAL
);
BOOL
WINAPI
CryptUIDlgViewCertificateA(
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
BOOL
WINAPI
CryptUIDlgViewCertificatePropertiesW(
IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW pcsp,
OUT BOOL *pfPropertiesChanged // OPTIONAL
);
BOOL
WINAPI
CryptUIDlgViewCertificatePropertiesA(
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
BOOL
WINAPI
CryptUIGetCertificatePropertiesPagesW(
IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTW pcsp,
OUT BOOL *pfPropertiesChanged, // OPTIONAL
OUT PROPSHEETPAGEW **prghPropPages,
OUT DWORD *pcPropPages
);
BOOL
WINAPI
CryptUIGetCertificatePropertiesPagesA(
IN PCCRYPTUI_VIEWCERTIFICATEPROPERTIES_STRUCTA pcsp,
OUT BOOL *pfPropertiesChanged, // OPTIONAL
OUT PROPSHEETPAGEA **prghPropPages,
OUT DWORD *pcPropPages
);
BOOL
WINAPI
CryptUIFreeCertificatePropertiesPagesW(
IN PROPSHEETPAGEW *rghPropPages,
IN DWORD cPropPages
);
BOOL
WINAPI
CryptUIFreeCertificatePropertiesPagesA(
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;
BOOL
WINAPI
CryptUIDlgViewCTLW(
IN PCCRYPTUI_VIEWCTL_STRUCTW pcvctl
);
BOOL
WINAPI
CryptUIDlgViewCTLA(
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;
BOOL
WINAPI
CryptUIDlgViewCRLW(
IN PCCRYPTUI_VIEWCRL_STRUCTW pcvcrl
);
BOOL
WINAPI
CryptUIDlgViewCRLA(
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;
BOOL
WINAPI
CryptUIDlgViewSignerInfoW(
IN PCCRYPTUI_VIEWSIGNERINFO_STRUCTW pcvsi
);
BOOL
WINAPI
CryptUIDlgViewSignerInfoA(
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
BOOL
WINAPI
CryptUIGetViewSignaturesPagesW(
IN PCCRYPTUI_VIEWSIGNATURES_STRUCTW pcvs,
OUT PROPSHEETPAGEW **prghPropPages,
OUT DWORD *pcPropPages
);
BOOL
WINAPI
CryptUIGetViewSignaturesPagesA(
IN PCCRYPTUI_VIEWSIGNATURES_STRUCTA pcvs,
OUT PROPSHEETPAGEA **prghPropPages,
OUT DWORD *pcPropPages
);
BOOL
WINAPI
CryptUIFreeViewSignaturesPagesW(
IN PROPSHEETPAGEW *rghPropPages,
IN DWORD cPropPages
);
BOOL
WINAPI
CryptUIFreeViewSignaturesPagesA(
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
//
HCERTSTORE
WINAPI
CryptUIDlgSelectStoreW(
IN PCCRYPTUI_SELECTSTORE_STRUCTW pcss
);
HCERTSTORE
WINAPI
CryptUIDlgSelectStoreA(
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_CONTEXT
WINAPI
CryptUIDlgSelectCertificateW(
IN PCCRYPTUI_SELECTCERTIFICATE_STRUCTW pcsc
);
PCCERT_CONTEXT
WINAPI
CryptUIDlgSelectCertificateA(
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_CONTEXT
WINAPI
CryptUIDlgSelectCA(
IN PCCRYPTUI_SELECT_CA_STRUCT pCryptUISelectCA
);
BOOL
WINAPI
CryptUIDlgFreeCAContext(
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
//
//
//--------------------------------------------------------------
BOOL
WINAPI
CryptUIDlgCertMgr(
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
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizCertRequest(
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().
//
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizCreateCertRequestNoDS
(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().
//
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizSubmitCertRequestNoDS
(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.
//
//------------------------------------------------------------------------
void
WINAPI
CryptUIWizFreeCertRequestNoDS
(IN HANDLE hRequest);
//------------------------------------------------------------------------
//
// CryptUIWizQueryCertRequestNoDS
//
// Queries status information about a created request.
//
// hRequest: IN Required.
// A HANDLE to the request to be freed.
//
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizQueryCertRequestNoDS
(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.
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizImport(
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
//
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizBuildCTL(
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.
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizExport(
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
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizDigitalSign(
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);
BOOL
WINAPI
CryptUIWizFreeDigitalSignContext(
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
//------------------------------------------------------------------------
BOOL
WINAPI
CryptUIWizGetDigitalSignPages(
IN PCRYPTUI_WIZ_GET_SIGN_PAGE_INFO pSignGetPageInfo,
OUT PROPSHEETPAGEW **prghPropPages,
OUT DWORD *pcPropPages);
BOOL
WINAPI
CryptUIWizFreeDigitalSignPages(
IN PROPSHEETPAGEW *rghPropPages,
IN DWORD cPropPages
);
DWORD
WINAPI
I_CryptUIProtect(
IN PVOID pvReserved1,
IN PVOID pvReserved2,
IN DWORD dwReserved3,
IN PVOID *pvReserved4,
IN BOOL fReserved5,
IN PVOID pvReserved6
);
DWORD
WINAPI
I_CryptUIProtectFailure(
IN PVOID pvReserved1,
IN DWORD dwReserved2,
IN PVOID *pvReserved3);
#include <poppack.h>
#ifdef __cplusplus
} // Balance extern "C" above
#endif
#endif // _CRYPTUI_H_