Fungsi CryptCATAdminAcquireContext (mscat.h)

  • Artikel

[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

Lihat juga

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog