structure CRYPTUI_VIEWCERTIFICATE_STRUCTA (cryptuiapi.h)

La structure CRYPTUI_VIEWCERTIFICATE_STRUCT contient des informations sur un certificat à afficher. Cette structure est utilisée dans la fonction CryptUIDlgViewCertificate.

Syntaxe

typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA {
  DWORD             dwSize;
  HWND              hwndParent;
  DWORD             dwFlags;
  LPCSTR            szTitle;
  PCCERT_CONTEXT    pCertContext;
  LPCSTR            *rgszPurposes;
  DWORD             cPurposes;
  union {
    CRYPT_PROVIDER_DATA const *pCryptProviderData;
    HANDLE                    hWVTStateData;
  };
  BOOL              fpCryptProviderDataTrustedUsage;
  DWORD             idxSigner;
  DWORD             idxCert;
  BOOL              fCounterSigner;
  DWORD             idxCounterSigner;
  DWORD             cStores;
  HCERTSTORE        *rghStores;
  DWORD             cPropSheetPages;
  LPCPROPSHEETPAGEA rgPropSheetPages;
  DWORD             nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;

Membres

dwSize

Taille, en octets, de la structure CRYPTUI_VIEWCERTIFICATE_STRUCT.

hwndParent

Handle de la fenêtre qui est le parent de la boîte de dialogue produite par CryptUIDlgViewCertificate.

dwFlags

Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
CRYPTUI_HIDE_HIERARCHYPAGE
La page chemin d’accès de certification est désactivée.
CRYPTUI_HIDE_DETAILPAGE
La page Détails est désactivée.
CRYPTUI_DISABLE_EDITPROPERTIES
L’utilisateur n’est pas autorisé à modifier les propriétés.
CRYPTUI_ENABLE_EDITPROPERTIES
L’utilisateur est autorisé à modifier les propriétés.
CRYPTUI_DISABLE_ADDTOSTORE
Le bouton Installer est désactivé.
CRYPTUI_ENABLE_ADDTOSTORE
Le bouton Installer est activé.
CRYPTUI_ACCEPT_DECLINE_STYLE
Les pages ou boutons qui permettent à l’utilisateur d’accepter ou de refuser toute décision sont désactivés.
CRYPTUI_IGNORE_UNTRUSTED_ROOT
Une erreur racine non approuvée est ignorée.
CRYPTUI_DONT_OPEN_STORES
Les magasins approuvés connus ne seront pas utilisés pour générer la chaîne.
CRYPTUI_ONLY_OPEN_ROOT_STORE
Un magasin racine approuvé connu ne sera pas utilisé pour générer la chaîne.
CRYPTUI_WARN_UNTRUSTED_ROOT
Utilisez uniquement lorsque vous affichez des certificats sur des ordinateurs distants. Si cet indicateur est utilisé, le premier élément de rghStores doit être le handle du magasin racine sur l’ordinateur distant.
CRYPTUI_ENABLE_REVOCATION_CHECKING
Activez la vérification de la révocation avec le comportement par défaut. Le comportement par défaut consiste à activer la vérification de révocation de l’ensemble de la chaîne de certificats, à l’exception du certificat racine. Valide uniquement si ni le pCryptProviderData ni le membre de l’union hWVTStateData n’est transmis.
CRYPTUI_WARN_REMOTE_TRUST
Lors de la création d’une chaîne de certificats pour un ordinateur distant, avertissez que la chaîne peut ne pas être approuvée sur l’ordinateur distant.
CRYPTUI_DISABLE_EXPORT
Si cet indicateur est défini, le bouton Copier dans le fichier est désactivé sur la page détails .
CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT
Activez la vérification de révocation uniquement sur le certificat feuille dans la chaîne de certificats. Valide uniquement si ni le pCryptProviderData ni le membre de l’union hWVTStateData n’est transmis.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN
Activez la vérification de révocation sur chaque certificat de la chaîne de certificats. Valide uniquement si ni le pCryptProviderData ni le membre de l’union hWVTStateData n’est transmis.

Remarque Étant donné que les certificats racines contiennent rarement des informations qui autorisent la vérification de la révocation, il est prévu que l’utilisation de cette option entraîne généralement l’échec de la fonction CryptUIDlgViewCertificate. L’option recommandée consiste à utiliser CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT.

CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT
Activez la vérification de révocation sur chaque certificat de la chaîne de certificats, à l’exception du certificat racine. Il s’agit de l’option recommandée à utiliser pour la vérification de la révocation de certificats. Valide uniquement si ni le pCryptProviderData ni le membre de l’union hWVTStateData n’est transmis.

Remarque Cet indicateur équivaut à CRYPTUI_ENABLE_REVOCATION_CHECKING.

CRYPTUI_DISABLE_HTMLLINK
Désactivez le bouton d’aide HTML (?) dans la boîte de dialogue certificat .
CRYPTUI_DISABLE_ISSUERSTATEMENT
Désactivez le bouton de l’instruction émetteur sous l’onglet Général de la boîte de dialogue certificat .
CRYPTUI_CACHE_ONLY_URL_RETRIEVAL
Désactivez la vérification de révocation en ligne. Définissez cet indicateur pour vous assurer que la fonction CryptUIDlgViewCertificate utilise le cache local pour récupérer le certificat et ne tente pas de récupérer le certificat à partir du réseau.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : cet indicateur n’est pas pris en charge.

szTitle

Pointeur vers une chaîne terminée par null qui contient le titre de la fenêtre.

pCertContext

Pointeur vers la structure CERT_CONTEXT qui contient le contexte de certificat à afficher.

rgszPurposes

Tableau de pointeurs vers des chaînes terminées par null qui contiennent les objectifs pour lesquels ce certificat sera validé.

cPurposes

Nombre d’objectifs dans le tableau rgszPurposes.

pCryptProviderData

Si la fonction WinVerifyTrust a déjà été appelée pour le certificat et que la fonction WTHelperProvDataFromStateData a également été appelée, passez un pointeur vers la structure d’état qui a été acquise à partir de l’appel à WTHelperProvDataFromStateData. Si pCryptProviderData est défini, fpCryptProviderDataTrustedUsage, idxSigner, idxCertet fCounterSignature doivent également être définis.

hWVTStateData

Si WinVerifyTrust a déjà été appelé pour le certificat et WTHelperProvDataFromStateData n’a pas été appelé, transmettez le hWVTStateData membre de la structure WINTRUST_DATA. Si hWVTStateData est défini, fpCryptProviderDataTrustedUsage, idxSigner, idxCertet fCounterSignature doivent également être définis.

fpCryptProviderDataTrustedUsage

Si WinVerifyTrust a été appelé, il s’agit du résultat de la confiance du certificat.

idxSigner

Index du signataire à afficher.

idxCert

Index du certificat en cours d’affichage dans la chaîne de signataires. Le contexte de certificat de ce certificat doit correspondre à pCertContext.

fCounterSigner

TRUE si une contre-signature est en cours d’affichage. S’il s’agit de TRUE, idxCounterSigner doit être valide.

idxCounterSigner

Index du contre-signeur à afficher.

cStores

Nombre d’autres magasins dans les magasins rghStores tableau de magasins de certificats à rechercher lors de la génération et de la validation de la chaîne de certificats.

rghStores

Tableau de HCERTSTORE gère vers d’autres magasins de certificats à rechercher lors de la génération et de la validation de la chaîne de certificats.

cPropSheetPages

Nombre de pages de propriétés à ajouter à la boîte de dialogue.

rgPropSheetPages

Tableau de pages de propriétés à ajouter à la boîte de dialogue. Chaque page de ce tableau ne reçoit pas le lParam dans la structure PROPSHEETPAGE comme lParam dans le message WM_INITDIALOG. Il reçoit plutôt un pointeur vers une structure CRYPTUI_INITDIALOG_STRUCT. Il contient le lParam dans PROPSHEETPAGE et le pointeur vers le CERT_CONTEXT pour lequel la page est affichée.

nStartPage

Index de la page initiale qui s’affiche. Si le bit le plus élevé (0x8000) est défini, l’index est supposé indexer rgPropSheetPages (une fois le bit le plus élevé supprimé, par exemple, 0x8000 indiquera la première page de rgPropSheetPages). Si le bit le plus élevé est égal à zéro, nStartPage sera l’index de départ des pages de propriétés de la boîte de dialogue de certificat par défaut.

Remarques

Notes

L’en-tête cryptuiapi.h définit CRYPTUI_VIEWCERTIFICATE_STRUCT en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête cryptuiapi.h

Voir aussi

CryptUIDlgViewCertificate