CryptCATAdminAddCatalog 関数 (mscat.h)

  • [アーティクル]

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

CryptCATAdminAddCatalog 関数はカタログ データベースにカタログを追加します。 カタログ データベースは、ファイル ハッシュを含むカタログに関連付けるインデックスです。 これは、ファイル署名を検証するときにカタログの識別を高速化するために使用されます。 この関数は、プログラムによって Windows カタログ データベースにカタログを追加する唯一のサポートされている方法です。 関数には、関連付けられたインポート ライブラリがありません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Wintrust.dll に動的にリンクする必要があります。

構文

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

パラメーター

[in] hCatAdmin

CryptCATAdminAcquireContext 関数によって以前に割り当てられたハンドル。

[in] pwszCatalogFile

追加するカタログの完全修飾パスの null で終わる文字列へのポインター。

[in] pwszSelectBaseName

カタログの格納時に、カタログの名前の null で終わる文字列へのポインター。 パラメーターが NULL の場合、カタログに対して一意の名前が生成されます。

[in] dwFlags

CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) フラグが指定されている場合、呼び出しで指定されたカタログは、コピーされるのではなく、 にハードリンクされます。 カタログをコピーする代わりにハード リンクすると、Windows で必要なディスク領域が減ります。

戻り値

関数が成功した場合、戻り値はカタログ情報コンテキストへのハンドルです。 関数が失敗した場合は、返される値は NULL です。 返されたハンドルの使用が完了したら、 CryptCATAdminReleaseCatalogContext 関数を呼び出して解放します。

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

要件

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

こちらもご覧ください

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext