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 函式。 如需作業系統所提供的錯誤碼完整清單，請參閱 系統錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 mscat.h
程式庫 Wintrust.lib
Dll Wintrust.dll

另請參閱

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog