Fungsi CryptCATOpen (mscat.h)

  • Artikel

[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