CryptCATAdminAcquireContext 関数 (mscat.h)

[ CryptCATAdminAcquireContext 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

CryptCATAdminAcquireContext 関数は、カタログ管理者コンテキストへのハンドルを取得します。 このハンドルは、 CryptCATAdminAddCatalog、 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

使用されません。を 0 に設定します。

戻り値

関数が成功した場合、戻り値は TRUE です。関数が失敗した場合は FALSE 。

拡張エラー情報については、 GetLastError 関数を呼び出します。 オペレーティング システムによって提供されるエラー コードの完全な一覧については、「 システム エラー コード」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー mscat.h
Library Wintrust.lib
[DLL] Wintrust.dll

こちらもご覧ください

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog