Fungsi CryptCATAdminAddCatalog (mscat.h)

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

Fungsi CryptCATAdminAddCatalog menambahkan katalog ke database katalog. Database katalog adalah indeks yang mengaitkan hash file dengan katalog yang berisinya. Ini digunakan untuk mempercepat identifikasi katalog saat memverifikasi tanda tangan file. Fungsi ini adalah satu-satunya cara yang didukung untuk menambahkan katalog secara terprogram ke database katalog Windows. Fungsi ini tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Wintrust.dll.

Sintaks

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

Parameter

[in] hCatAdmin

Tangani yang sebelumnya ditetapkan oleh fungsi CryptCATAdminAcquireContext .

[in] pwszCatalogFile

Penunjuk ke string yang dihentikan null untuk jalur katalog yang sepenuhnya memenuhi syarat untuk ditambahkan.

[in] pwszSelectBaseName

Penunjuk ke string yang dihentikan null untuk nama katalog saat disimpan. Jika parameter adalah NULL, maka nama unik akan dibuat untuk katalog.

[in] dwFlags

Jika bendera CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) ditentukan, katalog yang ditentukan dalam panggilan akan ditautkan secara permanen daripada disalin. Hard-linking alih-alih menyalin katalog mengurangi jumlah ruang disk yang diperlukan oleh Windows.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke konteks informasi katalog. Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Setelah Anda selesai menggunakan handel yang dikembalikan, bebaskan dengan memanggil fungsi CryptCATAdminReleaseCatalogContext .

Untuk informasi kesalahan yang diperluas, panggil fungsi GetLastError . Untuk daftar lengkap kode kesalahan yang disediakan oleh sistem operasi, lihat Kode Kesalahan Sistem.

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

Lihat juga

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext