CryptCATAdminAcquireContext 函式 (mscat.h)

[ CryptCATAdminAcquireContext 函式可用於需求一節中指定的操作系統。它可能會在後續版本中改變或無法使用。]

CryptCATAdminAcquireContext 函式會取得目錄管理員內容的句柄。後續呼叫 CryptCATAddCatalog、 CryptCATAdminEnumCatalogFromHash 和 CryptCATAdminRemoveCatalog 函式可以使用此句柄。此函式沒有相關聯的匯入連結庫。您必須使用 LoadLibrary 和 GetProcAddress 函式，以動態方式連結至 Wintrust.dll。

語法

BOOL CryptCATAdminAcquireContext(
  [out] HCATADMIN  *phCatAdmin,
  [in]  const GUID *pgSubsystem,
  [in]  DWORD      dwFlags
);

[out] phCatAdmin

此函式指派之目錄管理員內容句柄的指標。當您完成使用句柄時，請呼叫 CryptCATAdminReleaseContext 函式加以關閉。

[in] pgSubsystem

識別子系統之 GUID 的指標。 DRIVER_ACTION_VERIFY代表作業系統元件和第三方驅動程式的子系統。這是大部分實作所使用的子系統。

[in] dwFlags

未使用;設定為零。

如果函式成功，則傳回值為 TRUE ;如果函式失敗，則為 FALSE 。

如需擴充錯誤資訊，請呼叫 GetLastError 函式。如需作業系統所提供的錯誤碼完整清單，請參閱系統錯誤碼。