2 * Copyright (C) 2008 Juan Lang
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
18 #ifndef __CRYPTUIAPI_H__
19 #define __CRYPTUIAPI_H__
31 BOOL WINAPI CryptUIDlgViewContext(DWORD dwContextType, LPVOID pvContext,
32 HWND hwnd, LPCWSTR pwszTitle, DWORD dwFlags, LPVOID pvReserved);
34 /* Values for dwDontUseColumn */
35 #define CRYPTUI_SELECT_ISSUEDTO_COLUMN 0x00000001
36 #define CRYPTUI_SELECT_ISSUEDBY_COLUMN 0x00000002
37 #define CRYPTUI_SELECT_INTENDEDUSE_COLUMN 0x00000004
38 #define CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 0x00000008
39 #define CRYPTUI_SELECT_LOCATION_COLUMN 0x00000010
40 #define CRYPTUI_SELECT_EXPIRATION_COLUMN 0x00000020
42 PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificateFromStore(
43 HCERTSTORE hCertStore, HWND hwnd, LPCWSTR pwszTitle, LPCWSTR pwszDisplayString,
44 DWORD dwDontUseColumn, DWORD dwFlags, LPVOID pvReserved);
46 /* Values for CRYPTUI_CERT_MGR_STRUCT's dwFlags */
47 #define CRYPTUI_CERT_MGR_PUBLISHER_TAB 0x00000004
48 #define CRYPTUI_CERT_MGR_TAB_MASK 0x0000000f
49 #define CRYPTUI_CERT_MGR_SINGLE_TAB_FLAG 0x00008000
51 typedef struct _CRYPTUI_CERT_MGR_STRUCT
57 LPCSTR pszInitUsageOID;
58 } CRYPTUI_CERT_MGR_STRUCT, *PCRYPTUI_CERT_MGR_STRUCT;
59 typedef const struct _CRYPTUI_CERT_MGR_STRUCT *PCCRYPTUI_CERT_MGR_STRUCT;
61 BOOL WINAPI CryptUIDlgCertMgr(PCCRYPTUI_CERT_MGR_STRUCT pCryptUICertMgr);
63 typedef BOOL (WINAPI *PFNCFILTERPROC)(PCCERT_CONTEXT pCertContext,
64 BOOL *pfInitialSelectedCert, void *pvCallbackData);
66 typedef struct tagCRYPTUI_INITDIALOG_STRUCT
69 PCCERT_CONTEXT pCertContext;
70 } CRYPTUI_INITDIALOG_STRUCT, *PCRYPTUI_INITDIALOG_STRUCT;
72 /* Values for CRYPTUI_VIEWCERTIFICATE_STRUCT's dwFlags */
73 #define CRYPTUI_HIDE_HIERARCHYPAGE 0x00000001
74 #define CRYPTUI_HIDE_DETAILPAGE 0x00000002
75 #define CRYPTUI_DISABLE_EDITPROPERTIES 0x00000004
76 #define CRYPTUI_ENABLE_EDITPROPERTIES 0x00000008
77 #define CRYPTUI_DISABLE_ADDTOSTORE 0x00000010
78 #define CRYPTUI_ENABLE_ADDTOSTORE 0x00000020
79 #define CRYPTUI_ACCEPT_DECLINE_STYLE 0x00000040
80 #define CRYPTUI_IGNORE_UNTRUSTED_ROOT 0x00000080
81 #define CRYPTUI_DONT_OPEN_STORES 0x00000100
82 #define CRYPTUI_ONLY_OPEN_ROOT_STORE 0x00000200
83 #define CRYPTUI_WARN_UNTRUSTED_ROOT 0x00000400
84 #define CRYPTUI_ENABLE_REVOCATION_CHECKING 0x00000800
85 #define CRYPTUI_WARN_REMOTE_TRUST 0x00001000
86 #define CRYPTUI_DISABLE_EXPORT 0x00002000
87 #define CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT 0x00004000
88 #define CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN 0x00008000
89 #define CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT CRYPTUI_ENABLE_REVOCATION_CHECKING
90 #define CRYPTUI_DISABLE_HTMLLINK 0x00010000
91 #define CRYPTUI_DISABLE_ISSUERSTATEMENT 0x00020000
93 typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA
99 PCCERT_CONTEXT pCertContext;
100 LPCSTR *rgszPurposes;
103 CRYPT_PROVIDER_DATA const *pCryptProviderData;
104 HANDLE hWVTStateData;
106 BOOL fpCryptProviderDataTrustedUsage;
110 DWORD idxCounterSigner;
112 HCERTSTORE *rghStores;
113 DWORD cPropSheetPages;
114 LPCPROPSHEETPAGEA rgPropSheetPages;
116 } CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;
117 typedef const CRYPTUI_VIEWCERTIFICATE_STRUCTA *PCCRYPTUI_VIEWCERTIFICATE_STRUCTA;
119 typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTW
125 PCCERT_CONTEXT pCertContext;
126 LPCSTR *rgszPurposes;
129 CRYPT_PROVIDER_DATA const *pCryptProviderData;
130 HANDLE hWVTStateData;
132 BOOL fpCryptProviderDataTrustedUsage;
136 DWORD idxCounterSigner;
138 HCERTSTORE *rghStores;
139 DWORD cPropSheetPages;
140 LPCPROPSHEETPAGEW rgPropSheetPages;
142 } CRYPTUI_VIEWCERTIFICATE_STRUCTW, *PCRYPTUI_VIEWCERTIFICATE_STRUCTW;
143 typedef const CRYPTUI_VIEWCERTIFICATE_STRUCTW *PCCRYPTUI_VIEWCERTIFICATE_STRUCTW;
145 #define CRYPTUI_VIEWCERTIFICATE_STRUCT WINELIB_NAME_AW(CRYPTUI_VIEWCERTIFICATE_STRUCT)
146 #define PCCRYPTUI_VIEWCERTIFICATE_STRUCT WINELIB_NAME_AW(PCCRYPTUI_VIEWCERTIFICATE_STRUCT)
148 BOOL WINAPI CryptUIDlgViewCertificateA(
149 PCCRYPTUI_VIEWCERTIFICATE_STRUCTA pCertViewInfo, BOOL *pfPropertiesChanged);
150 BOOL WINAPI CryptUIDlgViewCertificateW(
151 PCCRYPTUI_VIEWCERTIFICATE_STRUCTW pCertViewInfo, BOOL *pfPropertiesChanged);
152 #define CryptUIDlgViewCertificate WINELIB_NAME_AW(CryptUIDlgViewCertificate)
154 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO
160 LPCWSTR pwszDisplayName;
161 } CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO;
162 typedef const CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO *
163 PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO;
165 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO
169 HCERTSTORE *rghCertStore;
170 PFNCFILTERPROC pFilterCallback;
171 void *pvCallbackData;
172 } CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO;
173 typedef const CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO *
174 PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO;
176 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO
179 LPWSTR pwszPvkFileName;
182 } CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO,
183 *PCRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO;
184 typedef const CRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO *
185 PCCRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO;
187 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO
190 LPWSTR pwszSigningCertFileName;
193 PCCRYPTUI_WIZ_DIGITAL_SIGN_PVK_FILE_INFO pPvkFileInfo;
194 PCRYPT_KEY_PROV_INFO pPvkProvInfo;
196 } CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO,
197 *PCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO;
198 typedef const CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO *
199 PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO;
201 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO
205 LPCWSTR pwszDescription;
206 LPCWSTR pwszMoreInfoLocation;
208 LPCWSTR pwszSigningCertDisplayString;
209 HCERTSTORE hAdditionalCertStore;
210 PCRYPT_ATTRIBUTES psAuthenticated;
211 PCRYPT_ATTRIBUTES psUnauthenticated;
212 } CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO,
213 *PCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO;
214 typedef const CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO *
215 PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO;
217 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO
220 DWORD dwSubjectChoice;
222 LPCWSTR pwszFileName;
223 PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo;
225 DWORD dwSigningCertChoice;
227 PCCERT_CONTEXT pSigningCertContext;
228 PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO pSigningCertStore;
229 PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo;
231 LPCWSTR pwszTimestampURL;
232 DWORD dwAdditionalCertChoice;
233 PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
234 } CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;
235 typedef const CRYPTUI_WIZ_DIGITAL_SIGN_INFO *PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO;
237 typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT
242 } CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT, *PCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT;
244 /* Values for CryptUIWizDigitalSign's dwFlags */
245 #define CRYPTUI_WIZ_NO_UI 0x00000001
246 #define CRYPTUI_WIZ_DIGITAL_SIGN_EXCLUDE_PAGE_HASHES 0x00000002
247 #define CRYPTUI_WIZ_DIGITAL_SIGN_INCLUDE_PAGE_HASHES 0x00000004
249 BOOL WINAPI CryptUIWizDigitalSign(DWORD dwFlags, HWND hwndParent,
250 LPCWSTR pwszWizardTitle, PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO pDigitalSignInfo,
251 PCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext);
253 BOOL WINAPI CryptUIWizFreeDigitalSignContext(
254 PCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT pSignContext);
256 /* Values for CRYPTUI_WIZ_EXPORT_INFO's dwSubjectChoice */
257 #define CRYPTUI_WIZ_EXPORT_CERT_CONTEXT 1
258 #define CRYPTUI_WIZ_EXPORT_CTL_CONTEXT 2
259 #define CRYPTUI_WIZ_EXPORT_CRL_CONTEXT 3
260 #define CRYPTUI_WIZ_EXPORT_CERT_STORE 4
261 #define CRYPTUI_WIZ_EXPORT_CERT_STORE_CERTIFICATES_ONLY 5
262 #define CRYPTUI_WIZ_EXPORT_FORMAT_CRL 6
263 #define CRYPTUI_WIZ_EXPORT_FORMAT_CTL 7
265 typedef struct _CRYPTUI_WIZ_EXPORT_INFO
268 LPCWSTR pwszExportFileName;
269 DWORD dwSubjectChoice;
271 PCCERT_CONTEXT pCertContext;
272 PCCTL_CONTEXT pCTLContext;
273 PCCRL_CONTEXT pCRLContext;
274 HCERTSTORE hCertStore;
277 HCERTSTORE *rghStores;
278 } CRYPTUI_WIZ_EXPORT_INFO, *PCRYPTUI_WIZ_EXPORT_INFO;
279 typedef const CRYPTUI_WIZ_EXPORT_INFO *PCCRYPTUI_WIZ_EXPORT_INFO;
281 /* Values for CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO's dwExportFormat */
282 #define CRYPTUI_WIZ_EXPORT_FORMAT_DER 1
283 #define CRYPTUI_WIZ_EXPORT_FORMAT_PFX 2
284 #define CRYPTUI_WIZ_EXPORT_FORMAT_PKCS7 3
285 #define CRYPTUI_WIZ_EXPORT_FORMAT_BASE64 4
286 #define CRYPTUI_WIZ_EXPORT_FORMAT_SERIALIZED_CERT_STORE 5
288 typedef struct _CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO
291 DWORD dwExportFormat;
293 BOOL fExportPrivateKeys;
294 LPCWSTR pwszPassword;
295 BOOL fStrongEncryption;
296 } CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO, *PCRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO;
297 typedef const CRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO *
298 PCCRYPTUI_WIZ_EXPORT_CERTCONTEXT_INFO;
300 BOOL WINAPI CryptUIWizExport(DWORD dwFlags, HWND hwndParent,
301 LPCWSTR pwszWizardTitle, PCCRYPTUI_WIZ_EXPORT_INFO pExportInfo, void *pvoid);
303 /* Values for CRYPTUI_WIZ_IMPORT_SRC_INFO's dwSubjectChoice */
304 #define CRYPTUI_WIZ_IMPORT_SUBJECT_FILE 1
305 #define CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT 2
306 #define CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT 3
307 #define CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT 4
308 #define CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE 5
310 typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO
313 DWORD dwSubjectChoice;
315 LPCWSTR pwszFileName;
316 PCCERT_CONTEXT pCertContext;
317 PCCTL_CONTEXT pCTLContext;
318 PCCRL_CONTEXT pCRLContext;
319 HCERTSTORE hCertStore;
322 LPCWSTR pwszPassword;
323 } CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;
324 typedef const CRYPTUI_WIZ_IMPORT_SRC_INFO *PCCRYPTUI_WIZ_IMPORT_SRC_INFO;
326 /* Values for CryptUIWizImport's dwFlags */
327 #define CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE 0x00010000
328 #define CRYPTUI_WIZ_IMPORT_ALLOW_CERT 0x00020000
329 #define CRYPTUI_WIZ_IMPORT_ALLOW_CRL 0x00040000
330 #define CRYPTUI_WIZ_IMPORT_ALLOW_CTL 0x00080000
331 #define CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE 0x00100000
332 #define CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER 0x00200000
333 #define CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE 0x00400000
335 BOOL WINAPI CryptUIWizImport(DWORD dwFlags, HWND hwndParent,
336 LPCWSTR pwszWizardTitle, PCCRYPTUI_WIZ_IMPORT_SRC_INFO pImportSrc,
337 HCERTSTORE hDestCertStore);
339 /* Definitions missing from PSDK's cryptuiapi.h, but documented on MSDN. */
340 typedef BOOL (WINAPI *PFNCCERTDISPLAYPROC)(PCCERT_CONTEXT pCertContext,
341 HWND hWndSelCertDlg, void *pvCallbackData);
343 /* Values for CRYPTUI_SELECTCERTIFICATE_STRUCT's dwFlags */
344 #define CRYPTUI_SELECTCERT_MULTISELECT 0x00000001
346 typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCTA
352 DWORD dwDontUseColumn;
353 LPCWSTR szDisplayString;
354 PFNCFILTERPROC pFilterCallback;
355 PFNCCERTDISPLAYPROC pDisplayCallback;
356 void *pvCallbackData;
358 HCERTSTORE *rghStores;
359 DWORD cPropSheetPages;
360 LPCPROPSHEETPAGEW rgPropSheetPages;
361 HCERTSTORE hSelectedCertStore;
362 } CRYPTUI_SELECTCERTIFICATE_STRUCTA, *PCRYPTUI_SELECTCERTIFICATE_STRUCTA;
363 typedef const CRYPTUI_SELECTCERTIFICATE_STRUCTA *
364 PCCRYPTUI_SELECTCERTIFICATE_STRUCTA;
366 typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCTW
372 DWORD dwDontUseColumn;
373 LPCWSTR szDisplayString;
374 PFNCFILTERPROC pFilterCallback;
375 PFNCCERTDISPLAYPROC pDisplayCallback;
376 void *pvCallbackData;
378 HCERTSTORE *rghStores;
379 DWORD cPropSheetPages;
380 LPCPROPSHEETPAGEW rgPropSheetPages;
381 HCERTSTORE hSelectedCertStore;
382 } CRYPTUI_SELECTCERTIFICATE_STRUCTW, *PCRYPTUI_SELECTCERTIFICATE_STRUCTW;
383 typedef const CRYPTUI_SELECTCERTIFICATE_STRUCTW *
384 PCCRYPTUI_SELECTCERTIFICATE_STRUCTW;
386 PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificateA(
387 PCCRYPTUI_SELECTCERTIFICATE_STRUCTA pcsc);
388 PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificateW(
389 PCCRYPTUI_SELECTCERTIFICATE_STRUCTW pcsc);
391 typedef struct tagCRYPTUI_VIEWSIGNERINFO_STRUCTA
397 CMSG_SIGNER_INFO *pSignerInfo;
400 DWORD_PTR dwReserved;
402 HCERTSTORE *rghStores;
403 DWORD cPropSheetPages;
404 LPCPROPSHEETPAGEA rgPropSheetPages;
405 } CRYPTUI_VIEWSIGNERINFO_STRUCTA, *PCRYPTUI_VIEWSIGNERINFO_STRUCTA;
407 typedef struct tagCRYPTUI_VIEWSIGNERINFO_STRUCTW
413 CMSG_SIGNER_INFO *pSignerInfo;
416 DWORD_PTR dwReserved;
418 HCERTSTORE *rghStores;
419 DWORD cPropSheetPages;
420 LPCPROPSHEETPAGEW rgPropSheetPages;
421 } CRYPTUI_VIEWSIGNERINFO_STRUCTW, *PCRYPTUI_VIEWSIGNERINFO_STRUCTW;
423 BOOL WINAPI CryptUIDlgViewSignerInfoA(CRYPTUI_VIEWSIGNERINFO_STRUCTA *pcvsi);
424 BOOL WINAPI CryptUIDlgViewSignerInfoW(CRYPTUI_VIEWSIGNERINFO_STRUCTW *pcvsi);