CRYPTUI_VIEWCERTIFICATE_STRUCTA Struktur (cryptuiapi.h)

Die CRYPTUI_VIEWCERTIFICATE_STRUCT-Struktur enthält Informationen zu einem anzuzeigenden Zertifikat. Diese Struktur wird in der funktion CryptUIDlgViewCertificate verwendet.

Syntax

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;

Angehörige

dwSize

Die Größe der CRYPTUI_VIEWCERTIFICATE_STRUCT Struktur in Byte.

hwndParent

Ein Handle für das Fenster, das das übergeordnete Element des Dialogfelds ist, das von CryptUIDlgViewCertificateerstellt wird.

dwFlags

Bei diesem Element kann es sich um einen oder mehrere der folgenden Werte handeln.

szTitle

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Titel für das Fenster enthält.

pCertContext

Ein Zeiger auf die CERT_CONTEXT Struktur, die den anzuzeigenden Zertifikatkontext enthält.

rgszPurposes

Ein Array von Zeigern auf null-beendete Zeichenfolgen, die die Zwecke enthalten, für die dieses Zertifikat überprüft wird.

cPurposes

Die Anzahl der Zwecke im rgszPurposes Array.

pCryptProviderData

Wenn die WinVerifyTrust--Funktion bereits für das Zertifikat aufgerufen wurde und die WTHelperProvDataFromStateData-Funktion auch aufgerufen wurde, übergeben Sie einen Zeiger auf die Zustandsstruktur, die vom Aufruf an WTHelperProvDataFromStateDataabgerufen wurde. Wenn pCryptProviderData festgelegt ist, müssen fpCryptProviderDataTrustedUsage, idxSigner, idxCertund fCounterSignature ebenfalls festgelegt werden.

hWVTStateData

Wenn WinVerifyTrust- bereits für das Zertifikat aufgerufen wurde und WTHelperProvDataFromStateData nicht aufgerufen wurde, übergeben Sie das hWVTStateData- Mitglied der WINTRUST_DATA-Struktur. Wenn hWVTStateData festgelegt ist, müssen fpCryptProviderDataTrustedUsage, idxSigner, idxCertund fCounterSignature ebenfalls festgelegt werden.

fpCryptProviderDataTrustedUsage

Wenn WinVerifyTrust aufgerufen wurde, ist dies das Ergebnis, ob das Zertifikat vertrauenswürdig war.

idxSigner

Der Index des anzuzeigenden Signierers.

idxCert

Der Index des Zertifikats, das in der Signiererkette angezeigt wird. Der Zertifikatkontext dieses Zertifikats muss pCertContext-übereinstimmen.

fCounterSigner

TRUE, wenn eine Gegensignatur angezeigt wird. Wenn dies TRUEist, muss idxCounterSigner gültig sein.

idxCounterSigner

Der Index des anzuzeigenden Gegenzeichens.

cStores

Die Anzahl der anderen Speicher im rghStores Array von Zertifikatspeichern, die beim Erstellen und Validieren der Zertifikatkette durchsucht werden sollen.

rghStores

Ein Array von HCERTSTORE- behandelt andere Zertifikatspeicher, um beim Erstellen und Validieren der Zertifikatkette zu suchen.

cPropSheetPages

Die Anzahl der Eigenschaftenseiten, die dem Dialogfeld hinzugefügt werden sollen.

rgPropSheetPages

Ein Array von Eigenschaftenseiten, die dem Dialogfeld hinzugefügt werden sollen. Jede Seite in diesem Array empfängt die lParam- in der PROPSHEETPAGE- Struktur nicht als lParam- in der WM_INITDIALOG Nachricht. Stattdessen wird ein Zeiger auf eine CRYPTUI_INITDIALOG_STRUCT Struktur empfangen. Sie enthält die lParam- in PROPSHEETPAGE- und den Zeiger auf die CERT_CONTEXT, für die die Seite angezeigt wird.

nStartPage

Der Index der anfänglichen Seite, die angezeigt wird. Wenn das höchste Bit (0x8000) festgelegt ist, wird der Index angenommen, um rgPropSheetPages zu indizieren (nachdem das höchste Bit entfernt wurde, z. B. gibt 0x8000 die erste Seite in rgPropSheetPages) an). Wenn das höchste Bit null ist, ist nStartPage- der Startindex der Eigenschaftenseiten des Standardzertifikatdialogfelds.

Bemerkungen

Anforderungen

Siehe auch

CryptUIDlgViewCertificate