Fungsi CryptCATCDFOpen (mscat.h)

Artikel
02/29/2024

[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

Lihat juga