CryptCATOpen-Funktion (mscat.h)

  • Artikel

[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