Fonction CryptUIDlgSelectCertificateFromStore (cryptuiapi.h)

  • Article

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