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 |
|---|---|
|
La page chemin d’accès de certification |
|
La page Détails est désactivée. |
|
L’utilisateur n’est pas autorisé à modifier les propriétés. |
|
L’utilisateur est autorisé à modifier les propriétés. |
|
Le bouton Installer est désactivé. |
|
Le bouton Installer est activé. |
|
Les pages ou boutons qui permettent à l’utilisateur d’accepter ou de refuser toute décision sont désactivés. |
|
Une erreur racine non approuvée est ignorée. |
|
Les magasins approuvés connus ne seront pas utilisés pour générer la chaîne. |
|
Un magasin racine approuvé connu ne sera pas utilisé pour générer la chaîne. |
|
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. |
|
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 |
|
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. |
|
Si cet indicateur est défini, le bouton |
|
Activez la vérification de révocation uniquement sur le certificat feuille dans la chaîne de certificats. Valide uniquement si ni le |
|
Activez la vérification de révocation sur chaque certificat de la chaîne de certificats. Valide uniquement si ni le 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. |
|
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 Remarque Cet indicateur équivaut à CRYPTUI_ENABLE_REVOCATION_CHECKING. |
|
Désactivez le bouton d’aide HTML ( |
|
Désactivez le bouton de l’instruction |
|
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
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
Note
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 |