CryptCATAdminEnumCatalogFromHash 関数 (mscat.h)

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

CryptCATAdminEnumCatalogFromHash 関数は、指定されたハッシュを含むカタログを列挙します。 ハッシュは通常、 CryptCATAdminCalcHashFromFileHandle 関数から返されます。 この関数の最後の呼び出しの後、 CryptCATAdminReleaseCatalogContext を呼び出して、割り当てられたメモリを解放します。

構文

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

パラメーター

[in] hCatAdmin

CryptCATAdminAcquireContext 関数によって以前に割り当てられたカタログ管理者コンテキストへのハンドル。

[in] pbHash

CryptCATAdminCalcHashFromFileHandle を呼び出して取得したハッシュを含むバッファーへのポインター。

[in] cbHash

pbHash に割り当てられたバッファー内のバイト数。

[in] dwFlags

このパラメーターは将来使用するために予約されており、0 に設定する必要があります。

[in] phPrevCatInfo

前のカタログ コンテキストまたは NULL へのハンドルへのポインター。 ハッシュを含む最初のカタログを取得するか、すべてのカタログの列挙を開始するには、このパラメーターに NULL を 渡します。 列挙を続行するには、これ以上カタログが見つからないまで、前の呼び出しの戻り値を渡します。

戻り値

戻り値はカタログ コンテキストへのハンドルです。列挙するカタログがこれ以上ない場合は NULL です。

メモ： HCATINFO 型は HANDLE の型定義に過ぎないため、誤って間違ったコンテキストで HCATINFO を簡単に使用できます。 特に、これは CryptCATOpen から返される HANDLE と同じではありません。ただし、コンパイラではカタログ ハンドルを必要とする関数で HCATINFO を使用できなくなります。 この関数からカタログ ハンドルを取得するには、まず CryptCATCatalogInfoFromContext を呼び出してカタログのファイル名を取得し、そのファイル名で CryptCATOpen を呼び出します。

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

メモ： 関数は HCATINFO 型の値を返しますが、これは単に HANDLE の typedef です。 このため、異なる種類の HANDLE を必要とする関数を呼び出すときに、誤って HCATINFO を使用するのは簡単です。 特に、これは CryptCATOpen から返される HANDLE と同じではありません。ただし、カタログ ハンドルを必要とする関数で HCATINFO を使用することはコンパイラによって妨げられません。

この関数からカタログ ハンドルを取得するには、まず CryptCATCatalogInfoFromContext を呼び出してカタログのファイル名を取得し、そのファイル名で CryptCATOpen を呼び出してカタログを開きます。

要件

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