CryptCATCDFOpen-Funktion (mscat.h)

Artikel
02/29/2024

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

Die CRYPTCATCDF-Struktur . CryptCATCDFOpen wird von MakeCat aufgerufen.

Syntax

CRYPTCATCDF * CryptCATCDFOpen(
  [in]           LPWSTR                       pwszFilePath,
  [in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Parameter

[in] pwszFilePath

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Pfad der zu öffnenden CDF-Datei enthält.

[in, optional] pfnParseError

Ein Zeiger auf eine benutzerdefinierte Funktion zum Behandeln von Dateianalysefehlern.

Rückgabewert

Nach erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf die neu erstellte CRYPTCATCDF-Struktur zurück. Die CryptCATCDFOpen-Funktion gibt einen NULL-Zeiger zurück, wenn ein Fehler auftritt.

Hinweise

Die folgenden Standardwerte werden von der CryptCATCDFOpen-Funktion für bestimmte Bedingungen im Abschnitt CDF CatalogHeader verwendet.

CatalogHeader-Bedingung	Standardwert
Es wird kein Name-Wert angegeben.	Der Dateiname in pwszFilePath wird für die Katalogausgabedatei (.cat) verwendet.
Es wird kein PublicVersion-Wert angegeben.	0x00000001
Es wird kein EncodingType-Wert angegeben.	PKCS_7_ASN_ENCODING oder X509_ASN_ENCODING (0x00010001)

Die folgenden Aktionen werden von der CryptCATCDFOpen-Funktion für bestimmte Fehlerbedingungen ausgeführt.

Fehlerzustand	Ausgeführte Aktion
In CDF sind keine CatalogHeader - oder Name-Tags vorhanden.	Wenn vom Aufrufer angegeben, ruft die CryptCATCDFOpen-Funktion die durch pfnParseError angegebene Funktion auf und gibt einen NULL-Zeiger zurück.
Die CryptCATCDFOpen-Funktion ruft die CryptCATOpen-Funktion auf, um ein Handle für die Katalogausgabedatei (.cat) abzurufen, aber sie ruft ein ungültiges oder NULL-Handle ab.	Ruft die CryptCATCDFClose-Funktion auf und gibt einen NULL-Zeiger zurück.

Zusätzliche OIDs für den Katalogbranch	Definition
szOID_CATALOG_LIST_MEMBER_V2	1.3.6.1.4.1.311.12.1.3
CAT_MEMBERINFO2_OBJID	1.3.6.1.4.1.311.12.2.3

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Die zusätzlichen Katalog-OIDs sind nicht verfügbar.

Anforderungen

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

Weitere Informationen