structure CRYPTUI_SELECTCERTIFICATE_STRUCT

Article
01/28/2024

La structure CRYPTUI_SELECTCERTIFICATE_STRUCT contient des informations sur la boîte de dialogue affichée par la fonction CryptUIDlgSelectCertificate .

Syntaxe

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

Membres

dwSize

Taille, en octets, de cette structure.

hwndParent

Handle de la fenêtre parente de la boîte de dialogue. Si cette valeur est NULL, la fenêtre parente est la fenêtre de bureau par défaut.

dwFlags

Spécifie des options supplémentaires pour la fonction CryptUIDlgSelectCertificate . Il peut s’agir de zéro ou d’une or au niveau du bit des valeurs suivantes.

Valeur	Signification
CRYPTUI_SELECTCERT_ADDFROMDS	Réservé.
CRYPTUI_SELECTCERT_LEGACY	Spécifie que la boîte de dialogue héritée doit être affichée.
CRYPTUI_SELECTCERT_MULTISELECT	Permet à l’utilisateur de sélectionner plusieurs certificats dans la boîte de dialogue. Si cet indicateur est défini, la fonction CryptUIDlgSelectCertificate retourne toujours NULL. Le membre hSelectedCertStore de cette structure doit contenir un handle dans un magasin de certificats. Les certificats sélectionnés par l’utilisateur seront ajoutés à ce magasin.
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST	Force l’interface utilisateur de chiffrement à être la fenêtre supérieure sur l’écran.

szTitle

Titre d’affichage de la boîte de dialogue. Si la valeur de ce membre est NULL, le titre par défaut de « Sélectionner un certificat » est utilisé.

dwDontUseColumn

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

Valeur	Signification
CRYPTUI_SELECT_ISSUEDTO_COLUMN 1 (0x1)	N’affichez pas les informations ISSUEDTO .
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2 (0x2)	N’affichez pas les informations ISSUEDBY .
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4 (0x4)	N’affichez pas les informations IntendedUse .
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8 (0x8)	N’affichez pas les informations de nom.
CRYPTUI_SELECT_LOCATION_COLUMN 16 (0x10)	N’affichez pas les informations d’emplacement.
CRYPTUI_SELECT_EXPIRATION_COLUMN 32 (0x20)	N’affichez pas les informations d’expiration.

szDisplayString

Texte affiché dans la boîte de dialogue pour indiquer à l’utilisateur. Si la valeur de ce membre est NULL, la chaîne par défaut « Sélectionner un certificat que vous souhaitez utiliser » est utilisée.

pFilterCallback

Pointeur vers une fonction de rappel PFNCFILTERPROC qui filtre les certificats affichés dans la boîte de dialogue.

pDisplayCallback

Pointeur vers une fonction de rappel PFNCCERTDISPLAYPROC qui affiche les certificats que l’utilisateur sélectionne pour afficher.

pvCallbackData

Données supplémentaires transmises aux fonctions de rappel spécifiées par les membres pFilterCallback et pDisplayCallback.

cDisplayStores

Nombre de magasins de certificats dans le tableau rghDisplayStores .

rghDisplayStores

Pointeur vers un tableau de magasins qui contiennent des certificats disponibles pour la sélection dans la boîte de dialogue.

cStores

Nombre de magasins de certificats dans le tableau rghStores .

rghStores

Pointeur vers un tableau de magasins de certificats à rechercher lors de la création d’une chaîne de certificats et vérification de l’approbation pour les certificats affichés dans la boîte de dialogue.

cPropSheetPages

Nombre de pages de propriétés dans le tableau rgPropSheetPages .

rgPropSheetPages

Pointeur vers un tableau de structures PROPSHEETPAGE qui représentent des pages de propriétés transmises à la boîte de dialogue d’affichage du certificat lorsqu’un certificat est sélectionné pour l’affichage.

hSelectedCertStore

Handle vers un magasin de certificats créé par l’appelant. Les certificats sélectionnés par l’utilisateur sont ajoutés à ce magasin. Si le nombre de certificats de ce magasin est le même avant et après l’appel de CryptUIDlgSelectCertificate, l’utilisateur a fermé la boîte de dialogue sans sélectionner de certificats.

Ce membre n’est pas utilisé si le membre dwFlags de cette structure ne contient pas l’indicateur CRYPTUI_SELECTCERT_MULTISELECT .

Spécifications

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]
Noms Unicode et ANSI	CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) et CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

Voir aussi

CryptUIDlgSelectCertificate

Share via