CryptUIDlgSelectCertificateFromStore function (cryptuiapi.h)
The CryptUIDlgSelectCertificateFromStore function displays a dialog box that allows the selection of a certificate from a specified store.
Syntax
PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
[in] HCERTSTORE hCertStore,
[in] HWND hwnd,
[in, optional] LPCWSTR pwszTitle,
[in, optional] LPCWSTR pwszDisplayString,
[in] DWORD dwDontUseColumn,
[in] DWORD dwFlags,
[in] void *pvReserved
);
Parameters
[in] hCertStore
Handle of the certificate store to be searched.
[in] hwnd
Handle of the window for the display. If NULL, defaults to the desktop window.
[in, optional] pwszTitle
String used as the title of the dialog box. If NULL, the default title, "Select Certificate," is used.
[in, optional] pwszDisplayString
Text statement in the selection dialog box. If NULL, the default phrase, "Select a certificate you want to use," is used.
[in] dwDontUseColumn
Flags that can be combined to exclude columns of the display.
[in] dwFlags
Currently not used and should be set to 0.
[in] pvReserved
Reserved for future use.
Return value
Returns a pointer to the selected certificate context. If no certificate was selected, NULL is returned. When you have finished using the certificate, free the certificate context by calling the CertFreeCertificateContext function.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | cryptuiapi.h |
Library | Cryptui.lib |
DLL | Cryptui.dll |