Fungsi CryptCATOpen (mscat.h)

Artikel
03/08/2023

[Fungsi CryptCATOpen tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi CryptCATOpen membuka katalog dan mengembalikan handel konteks ke katalog yang terbuka.

Catatan Beberapa versi Wintrust.lib yang lebih lama tidak berisi informasi ekspor untuk fungsi ini. Dalam hal ini, Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Wintrust.dll.

Sintaks

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Parameter

[in] pwszFileName

Penunjuk ke string yang dihentikan null untuk nama file katalog.

[in] fdwOpenFlags

Nol, untuk membuka file katalog yang ada, atau kombinasi bitwise dari satu atau beberapa nilai berikut.

Nilai	Makna
CRYPTCAT_OPEN_ALWAYS	Membuka file, jika ada, atau membuat file baru, jika diperlukan.
CRYPTCAT_OPEN_CREATENEW	File katalog baru dibuat. Jika ada file yang dibuat sebelumnya, file tersebut akan ditimpa.
CRYPTCAT_OPEN_EXISTING	File katalog yang ada dibuka.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES	File katalog yang ada dibuka. Kecualikan hash halaman di SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES	File katalog yang ada dibuka. Sertakan hash halaman di SPC_INDIRECT_DATA. CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES di atas lebih diutamakan jika juga ditetapkan.
CRYPTCAT_OPEN_VERIFYSIGHASH	File katalog yang ada dibuka. Memverifikasi tanda tangan, bukan sertifikat.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG	File katalog yang ada dibuka. Melakukan CryptMsgDecode tanpa konten.
CRYPTCAT_OPEN_SORTED	File katalog yang ada dibuka. Apakah CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG).

[in] hProv

Handel ke penyedia layanan kriptografi (CSP).

[in] dwPublicVersion

Versi file. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CRYPTCAT_VERSION_1 0x100	Format file versi 1.
CRYPTCAT_VERSION_2 0x200	Format file versi 2. Windows 8 dan Windows Server 2012: Dukungan untuk nilai ini dimulai.

[in] dwEncodingType

Jenis pengodean yang digunakan untuk file. Jika nilai ini adalah 0, maka jenis pengodean diatur ke PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

Nilai kembali

Setelah berhasil, fungsi ini mengembalikan handel ke katalog terbuka. Setelah Anda selesai menggunakan handel, tutup dengan memanggil fungsi CryptCATClose . Fungsi CryptCATOpen mengembalikan INVALID_HANDLE_VALUE jika gagal.

Persyaratan


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
Pustaka	Wintrust.lib
DLL	Wintrust.dll

Lihat juga

CryptCATClose

Bagikan melalui