Fungsi CryptCATAdminEnumCatalogFromHash (mscat.h)

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

Fungsi CryptCATAdminEnumCatalogFromHash menghitung katalog yang berisi hash tertentu. Hash biasanya dikembalikan dari fungsi CryptCATAdminCalcHashFromFileHandle . Setelah panggilan akhir ke fungsi ini, panggil CryptCATAdminReleaseCatalogContext untuk merilis memori yang dialokasikan.

Sintaks

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

Parameter

[in] hCatAdmin

Handel ke konteks administrator katalog yang sebelumnya ditetapkan oleh fungsi CryptCATAdminAcquireContext .

[in] pbHash

Penunjuk ke buffer yang berisi hash yang diambil dengan memanggil CryptCATAdminCalcHashFromFileHandle.

[in] cbHash

Jumlah byte dalam buffer yang dialokasikan untuk pbHash.

[in] dwFlags

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke nol.

[in] phPrevCatInfo

Penunjuk ke handel ke konteks katalog sebelumnya atau NULL. Untuk mendapatkan katalog pertama yang berisi hash, atau untuk memulai enumerasi semua katalog, teruskan NULL untuk parameter ini. Untuk melanjutkan enumerasi, berikan nilai pengembalian panggilan sebelumnya hingga tidak ada katalog lagi yang ditemukan.

Nilai kembali

Nilai yang dikembalikan adalah handel ke konteks katalog, atau NULL jika tidak ada katalog lagi untuk dijumlahkan.

Catatan: Jenis HCATINFO hanyalah typedef untuk HANDLE, yang memudahkan penggunaan HCATINFO secara tidak sengaja dalam konteks yang salah. Secara khusus, ini TIDAK sama dengan HANDLE yang dikembalikan dari CryptCATOpen, meskipun pengkompilasi tidak akan mencegah Anda menggunakan HCATINFO dalam fungsi apa pun yang mengharapkan handel katalog. Untuk memperoleh handel katalog dari fungsi ini, pertama-tama panggil CryptCATCatalogInfoFromContext untuk mendapatkan nama file katalog, lalu panggil CryptCATOpen dengan nama file tersebut.

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

Catatan: Fungsi mengembalikan nilai jenis HCATINFO, tetapi ini hanyalah typedef untuk HANDLE. Karena itu, mudah untuk secara tidak sengaja menggunakan HCATINFO saat memanggil fungsi yang mengharapkan jenis HANDLE yang berbeda. Secara khusus, ini tidak sama dengan HANDLE yang dikembalikan dari CryptCATOpen, meskipun pengkompilasi tidak akan mencegah Anda menggunakan HCATINFO dalam fungsi apa pun yang mengharapkan handel katalog.

Untuk memperoleh handel katalog dari fungsi ini, pertama-tama panggil CryptCATCatalogInfoFromContext untuk mendapatkan nama file katalog, lalu panggil CryptCATOpen dengan nama file tersebut untuk membuka katalog.

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