Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Die CryptCATCDFOpen-Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. 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
);
Die Parameter
[in] pwszFilePath
Ein Zeiger auf eine mit Null beendete 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
Bei Erfolg gibt diese Funktion einen Zeiger auf die neu erstellte CRYPTCATCDF-Struktur zurück. Die CryptCATCDFOpen-Funktion gibt einen NULL-Zeiger zurück, wenn er fehlschlägt.
Bemerkungen
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 | Aktion ausgeführt |
|---|---|
| In CDF befinden sich keine CatalogHeader - oder Name-Tags . | 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 es wird ein ungültiges oder NULL-Handle abgerufen. | Ruft die CryptCATCDFClose-Funktion auf und gibt einen NULL-Zeiger zurück. |
| Zusätzliche OIDs für den Katalogzweig | 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 |
|---|---|
| Mindestens unterstützter Client | Windows XP [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | mscat.h |
| Library | nanosrv.lib |
| DLL | Wintrust.dll |