CryptCATOpen-Funktion (mscat.h)

Artikel
08/24/2023

[Die CryptCATOpen-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CryptCATOpen-Funktion öffnet einen Katalog und gibt ein Kontexthandle an den geöffneten Katalog zurück.

Hinweis Einige ältere Versionen von Wintrust.lib enthalten keine Exportinformationen für diese Funktion. In diesem Fall müssen Sie die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Wintrust.dll.

Syntax

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Parameter

[in] pwszFileName

Ein Zeiger auf eine NULL-Zeichenfolge für den Katalogdateinamen.

[in] fdwOpenFlags

Null, um eine vorhandene Katalogdatei oder eine bitweise Kombination aus einem oder mehreren der folgenden Werte zu öffnen.

Wert	Bedeutung
CRYPTCAT_OPEN_ALWAYS	Öffnet die Datei, sofern vorhanden, oder erstellt bei Bedarf eine neue Datei.
CRYPTCAT_OPEN_CREATENEW	Eine neue Katalogdatei wird erstellt. Wenn eine zuvor erstellte Datei vorhanden ist, wird sie überschrieben.
CRYPTCAT_OPEN_EXISTING	Eine vorhandene Katalogdatei wird geöffnet.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES	Eine vorhandene Katalogdatei wird geöffnet. Ausschließen von Seitenhashes in SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES	Eine vorhandene Katalogdatei wird geöffnet. Schließen Sie Seitenhashes in SPC_INDIRECT_DATA ein. Die obige CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES hat Vorrang, wenn sie ebenfalls festgelegt ist.
CRYPTCAT_OPEN_VERIFYSIGHASH	Eine vorhandene Katalogdatei wird geöffnet. Überprüft die Signatur, nicht die Zertifikate.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG	Eine vorhandene Katalogdatei wird geöffnet. Führt CryptMsgDecode ohne Inhalt aus.
CRYPTCAT_OPEN_SORTED	Eine vorhandene Katalogdatei wird geöffnet. Führt CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG) aus.

[in] hProv

Ein Handle für einen Kryptografiedienstanbieter (CSP).

[in] dwPublicVersion

Version der Datei. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CRYPTCAT_VERSION_1 0x100	Dateiformat der Version 1.
CRYPTCAT_VERSION_2 0x200	Dateiformat der Version 2. Windows 8 und Windows Server 2012: Die Unterstützung für diesen Wert beginnt.

[in] dwEncodingType

Codierungstyp, der für die Datei verwendet wird. Wenn dieser Wert 0 ist, wird der Codierungstyp auf PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

Rückgabewert

Bei Erfolg gibt diese Funktion ein Handle an den geöffneten Katalog zurück. Wenn Sie mit der Verwendung des Handle fertig sind, schließen Sie es, indem Sie die Funktion CryptCATClose aufrufen. Die CryptCATOpen-Funktion gibt INVALID_HANDLE_VALUE zurück, wenn ein Fehler auftritt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mscat.h
Bibliothek	Wintrust.lib
DLL	Wintrust.dll

Weitere Informationen

CryptCATClose

Freigeben über