Fungsi CryptCATCDFOpen (mscat.h)
[Fungsi CryptCATCDFOpen tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]
Struktur CRYPTCATCDF . CryptCATCDFOpen dipanggil oleh MakeCat.
Sintaks
CRYPTCATCDF * CryptCATCDFOpen(
[in] LPWSTR pwszFilePath,
[in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
Parameter
[in] pwszFilePath
Penunjuk ke string yang dihentikan null yang berisi jalur file CDF yang akan dibuka.
[in, optional] pfnParseError
Penunjuk ke fungsi yang ditentukan pengguna untuk menangani kesalahan penguraian file.
Mengembalikan nilai
Setelah berhasil, fungsi ini mengembalikan penunjuk ke struktur CRYPTCATCDF yang baru dibuat. Fungsi CryptCATCDFOpen mengembalikan penunjuk NULL jika gagal.
Keterangan
Nilai default berikut digunakan oleh fungsi CryptCATCDFOpen untuk kondisi tertentu di bagian CatalogHeader CDF.
| Kondisi CatalogHeader | Nilai default |
|---|---|
| Tidak ada nilai Nama yang ditentukan. | Nama file dalam pwszFilePath digunakan untuk file output katalog (.cat). |
| Tidak ada nilai PublicVersion yang ditentukan. | 0x00000001 |
| Tidak ada nilai EncodingType yang ditentukan. | PKCS_7_ASN_ENCODING atau X509_ASN_ENCODING (0x00010001) |
Tindakan berikut dilakukan oleh fungsi CryptCATCDFOpen untuk kondisi kesalahan yang diberikan.
| Kondisi kesalahan | Tindakan yang dilakukan |
|---|---|
| Tidak ada tag CatalogHeader atau Nama yang ditemukan di CDF. | Jika ditentukan oleh pemanggil, fungsi CryptCATCDFOpen memanggil fungsi yang ditentukan oleh pfnParseError dan mengembalikan penunjuk NULL . |
| Fungsi CryptCATCDFOpen memanggil fungsi CryptCATOpen untuk mendapatkan handel ke file output katalog (.cat), tetapi mendapatkan handel null atau tidak valid. | Memanggil fungsi CryptCATCDFClose dan mengembalikan penunjuk NULL . |
| OID tambahan untuk cabang Katalog | Definisi |
|---|---|
| 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 dan Windows XP: OID Katalog tambahan tidak tersedia.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | mscat.h |
| DLL | Wintrust.dll |