Freigeben über


CryptCATCDFOpen-Funktion (mscat.h)

[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

CRYPTCATCDF

CryptCATCDFClose

CryptCATOpen

MakeCat