Fonction CryptUIDlgSelectCertificateFromStore (cryptuiapi.h)

Article
08/22/2023

La fonction CryptUIDlgSelectCertificateFromStore affiche une boîte de dialogue qui permet la sélection d’un certificat à partir d’un magasin spécifié.

Syntaxe

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
);

Paramètres

[in] hCertStore

Handle du magasin de certificats à rechercher.

[in] hwnd

Handle de la fenêtre pour l’affichage. Si la valeur est NULL, la valeur par défaut est la fenêtre de bureau.

[in, optional] pwszTitle

Chaîne utilisée comme titre de la boîte de dialogue. Si la valeur est NULL, le titre par défaut, « Sélectionner un certificat », est utilisé.

[in, optional] pwszDisplayString

Instruction text dans la boîte de dialogue de sélection. Si la valeur est NULL, l’expression par défaut « Sélectionner un certificat que vous souhaitez utiliser » est utilisée.

[in] dwDontUseColumn

Indicateurs qui peuvent être combinés pour exclure des colonnes de l’affichage.

Valeur	Signification
CRYPTUI_SELECT_ISSUEDTO_COLUMN	N’affichez pas les informations ISSUEDTO.
CRYPTUI_SELECT_ISSUEDBY_COLUMN	N’affichez pas les informations ISSUEDBY.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN	N’affichez pas les informations IntendedUse.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN	N’affichez pas les informations de nom d’affichage.
CRYPTUI_SELECT_LOCATION_COLUMN	N’affichez pas les informations d’emplacement.
CRYPTUI_SELECT_EXPIRATION_COLUMN	N’affichez pas les informations d’expiration.

[in] dwFlags

Actuellement non utilisé et doit être défini sur 0.

[in] pvReserved

Réservé pour un usage futur.

Valeur retournée

Retourne un pointeur vers le contexte de certificat sélectionné. Si aucun certificat n’a été sélectionné, NULL est retourné. Lorsque vous avez terminé d’utiliser le certificat, libérez le contexte du certificat en appelant la fonction CertFreeCertificateContext .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	cryptuiapi.h
Bibliothèque	Cryptui.lib
DLL	Cryptui.dll

Voir aussi

CryptUIDlgViewContext

Partager via