CRYPT_PROVIDER_DATA Struktur (wintrust.h)

[Die CRYPT_PROVIDER_DATA-Struktur steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CRYPT_PROVIDER_DATA-Struktur wird verwendet, um Daten zwischen WinVerifyTrust und Vertrauensanbietern zu übergeben.

Syntax

typedef struct _CRYPT_PROVIDER_DATA {
  DWORD                               cbStruct;
  WINTRUST_DATA                       *pWintrustData;
  BOOL                                fOpenedFile;
  HWND                                hWndParent;
  GUID                                *pgActionID;
  HCRYPTPROV                          hProv;
  DWORD                               dwError;
  DWORD                               dwRegSecuritySettings;
  DWORD                               dwRegPolicySettings;
  struct _CRYPT_PROVIDER_FUNCTIONS    *psPfns;
  DWORD                               cdwTrustStepErrors;
  DWORD                               *padwTrustStepErrors;
  DWORD                               chStores;
  HCERTSTORE                          *pahStores;
  DWORD                               dwEncoding;
  HCRYPTMSG                           hMsg;
  DWORD                               csSigners;
  struct _CRYPT_PROVIDER_SGNR         *pasSigners;
  DWORD                               csProvPrivData;
  struct _CRYPT_PROVIDER_PRIVDATA     *pasProvPrivData;
  DWORD                               dwSubjectChoice;
  union {
#if ...
    _PROVDATA_SIP        *pPDSip;
#else
    struct _PROVDATA_SIP *pPDSip;
#endif
  };
  char                                *pszUsageOID;
  BOOL                                fRecallWithState;
  FILETIME                            sftSystemTime;
  char                                *pszCTLSignerUsageOID;
  DWORD                               dwProvFlags;
  DWORD                               dwFinalError;
  PCERT_USAGE_MATCH                   pRequestUsage;
  DWORD                               dwTrustPubSettings;
  DWORD                               dwUIStateFlags;
  struct _CRYPT_PROVIDER_SIGSTATE     *pSigState;
  struct WINTRUST_SIGNATURE_SETTINGS_ *pSigSettings;
} CRYPT_PROVIDER_DATA, *PCRYPT_PROVIDER_DATA;

Member

cbStruct

Die Größe (in Bytes) dieser Struktur.

pWintrustData

Ein Zeiger auf eine WINTRUST_DATA Struktur, die die zu überprüfenden Informationen enthält.

fOpenedFile

Ein boolescher Wert, der angibt, ob der Vertrauensstellungsanbieter das Dateihandle geöffnet hat, falls zutreffend.

hWndParent

Ein Handle für das übergeordnete Fenster. Falls nicht angegeben, wird ein Handle für das Desktopfenster verwendet.

pgActionID

Ein Zeiger auf eine GUID-Struktur , die eine Aktion und den Vertrauensanbieter identifiziert, der diese Aktion unterstützt.

hProv

Ein Handle für den Kryptografiedienstanbieter (Cryptographic Service Provider , CSP). Wenn dieser Parameter NULL ist, stellt das Betriebssystem einen Standard-CSP bereit.

dwError

Eine Fehlerebene, wenn ein Systemfehler auf niedriger Ebene aufgetreten ist.

dwRegSecuritySettings

Die Registrierungssicherheitseinstellungen.

dwRegPolicySettings

Die Registrierungsrichtlinieneinstellungen.

psPfns

Ein Zeiger auf eine CRYPT_PROVIDER_FUNCTIONS Struktur.

cdwTrustStepErrors

Die Anzahl der Elemente im Array padwTrustStepErrors .

padwTrustStepErrors

Ein Array von DWORD-Werten , die Vertrauensschrittfehler angeben.

chStores

Die Anzahl der Elemente im pahStores-Array .

pahStores

Ein Array von Zertifikatspeicherhandles.

dwEncoding

Ein Wert, der den Codierungstyp angibt.

hMsg

Ein Handle für die kryptografische Nachricht.

csSigners

Die Anzahl der Elemente im pasSigners-Array .

pasSigners

Ein Zeiger auf ein Array von CRYPT_PROVIDER_SGNR Strukturen.

csProvPrivData

Die Anzahl der Elemente im pasProvPrivData-Array .

pasProvPrivData

Ein Zeiger auf ein Array von CRYPT_PROVIDER_PRIVDATA Strukturen.

dwSubjectChoice

Ein Wert, der die Auswahl des Antragstellers angibt.

pPDSip

Ein Zeiger auf eine _PROVDATA_SIP-Struktur .

pszUsageOID

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Nutzungsobjektbezeichner (Usage Object Identifier , OID) enthält.

fRecallWithState

Ein boolescher Wert, der angibt, ob der Zustand für Katalogdateien beibehalten wurde.

sftSystemTime

Die Systemzeit.

pszCTLSignerUsageOID

Ein Zeiger auf eine null-beendete Zeichenfolge, die die Zertifikatvertrauensliste (CTL)-Signerverwendungs-OID darstellt.

dwProvFlags

Eine bitweise Kombination aus mindestens einem der folgenden Flags.

Wert	Bedeutung
CPD_USE_NT5_CHAIN_FLAG 0x80000000	Verwenden Sie die Windows 2000-Verkettung.
CPD_REVOCATION_CHECK_NONE 0x00010000	Es wird keine Sperrüberprüfung durchgeführt.
CPD_REVOCATION_CHECK_END_CERT 0x00020000	Die Sperrüberprüfung für das Endzertifikat wird durchgeführt.
CPD_REVOCATION_CHECK_CHAIN 0x00040000	Die Sperrüberprüfung für die Zertifikatkette wird durchgeführt.
CPD_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT 0x00080000	Die Sperrüberprüfung für die Zertifikatkette wird mit Ausnahme des Stammzertifikats durchgeführt.

dwFinalError

Ein Wert für den endgültigen Fehler.

pRequestUsage

Ein Zeiger auf eine CERT_USAGE_MATCH-Struktur .

dwTrustPubSettings

Ein Wert für die Einstellungen des Vertrauensherausgebers.

dwUIStateFlags

Ein DWORD-Wert , der Zustandsdaten angibt, die zwischen einem Vertrauensstellungsanbieter und der Benutzeroberfläche übergeben werden.

Windows XP mit SP1 und Windows XP: Dieses Element wird ignoriert.

pSigState

pSigSettings

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wintrust.h