Fungsi CryptCATAdminAcquireContext (mscat.h)
[Fungsi CryptCATAdminAcquireContext tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]
Fungsi CryptCATAdminAcquireContext memperoleh handel ke konteks administrator katalog. Handel ini dapat digunakan oleh panggilan berikutnya ke fungsi CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash, dan CryptCATAdminRemoveCatalog . Fungsi ini tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Wintrust.dll.
Sintaks
BOOL CryptCATAdminAcquireContext(
[out] HCATADMIN *phCatAdmin,
[in] const GUID *pgSubsystem,
[in] DWORD dwFlags
);
Parameter
[out] phCatAdmin
Penunjuk ke handel konteks administrator katalog yang ditetapkan oleh fungsi ini. Setelah Anda selesai menggunakan handel, tutup dengan memanggil fungsi CryptCATAdminReleaseContext .
[in] pgSubsystem
Penunjuk ke GUID yang mengidentifikasi subsistem. DRIVER_ACTION_VERIFY mewakili subsistem untuk komponen sistem operasi dan driver pihak ketiga. Ini adalah subsistem yang digunakan oleh sebagian besar implementasi.
[in] dwFlags
Tidak digunakan; atur ke nol.
Nilai kembali
Nilai yang dikembalikan adalah TRUE jika fungsi berhasil; FALSE jika fungsi gagal.
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 |