CRYPTCATSTORE-Struktur (mscat.h)

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

Die CRYPTCATSTORE-Struktur stellt eine Katalogdatei dar. Die CryptCATStoreFromHandle-Funktion füllt diese Struktur mithilfe des von CryptCATOpen zurückgegebenen Handle auf.

Syntax

typedef struct CRYPTCATSTORE_ {
  DWORD      cbStruct;
  DWORD      dwPublicVersion;
  LPWSTR     pwszP7File;
  HCRYPTPROV hProv;
  DWORD      dwEncodingType;
  DWORD      fdwStoreFlags;
  HANDLE     hReserved;
  HANDLE     hAttrs;
  HCRYPTMSG  hCryptMsg;
  HANDLE     hSorted;
} CRYPTCATSTORE;

Members

cbStruct

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

dwPublicVersion

Ein Wert, der die "PublicVersion" der Katalogdatei angibt.

pwszP7File

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen der Katalogdatei enthält. Dieses Element muss vor einem Aufruf der CryptCATPersistStore-Funktion initialisiert werden.

hProv

Ein Handle für den Kryptografiedienstanbieter (Cryptographic Service Provider , CSP).

dwEncodingType

Ein Wert, der den für die Datei verwendeten Codierungstyp angibt. Derzeit werden nur X509_ASN_ENCODING und PKCS_7_ASN_ENCODING verwendet. Es können jedoch in Zukunft weitere Codierungstypen hinzugefügt werden. Verwenden Sie für einen der beiden aktuellen Codierungstypen: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

fdwStoreFlags

Eine bitweise Kombination der folgenden Werte.

Wert	Bedeutung
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES 0x00010000	Ausschließen von Seitenhashes in SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_FLAGS_MASK 0xffff0000	Legen Sie für alle Flags mit einem Wert im oberen Wort das Flag fest oder löschen Sie es.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES 0x00020000	Schließen Sie Seitenhashes in SPC_INDIRECT_DATA ein. Das CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES-Flag hat Vorrang, wenn es ebenfalls festgelegt ist.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG 0x20000000	Öffnen Sie die Datei zum Decodieren ohne getrennten Inhalt.
CRYPTCAT_OPEN_SORTED 0x40000000	Öffnen Sie den Katalog mit den Einträgen, die alphabetisch nach Betreff sortiert sind.
CRYPTCAT_OPEN_VERIFYSIGHASH 0x10000000	Überprüfen Sie den Signaturhash, aber nicht die Zertifikatkette.

hReserved

Dieser Member ist reserviert und muss NULL sein.

hAttrs

Dieser Member ist reserviert und muss NULL sein.

hCryptMsg

Ein Handle für die decodierten Bytes. Dieses Element wird nur festgelegt, wenn die Datei mit dem CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG-Flag geöffnet wurde.

hSorted

Dieser Member ist reserviert und muss NULL sein.

Anforderungen

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