CryptCATAdminCalcHashFromFileHandle 関数 (mscat.h)

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

CryptCATAdminCalcHashFromFileHandle 関数は、ファイルのハッシュを計算します。 この関数には、関連付けられたインポート ライブラリがありません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Wintrust.dll に動的にリンクする必要があります。

構文

BOOL CryptCATAdminCalcHashFromFileHandle(
  [in]      HANDLE hFile,
  [in, out] DWORD  *pcbHash,
  [in]      BYTE   *pbHash,
  [in]      DWORD  dwFlags
);

パラメーター

[in] hFile

ハッシュが計算されているファイルのハンドル。 このパラメーターは NULL にすることはできません。有効なファイル ハンドルである必要があります。

[in, out] pcbHash

pbHash 内のバイト数を含む DWORD 変数へのポインター。 入力時に、 pcbHash を pbHash に割り当てられたバイト数に設定 します。 返されると、 pcbHash には pbHash で返されたバイト数が含 まれます。 pbHash が NULL として渡された場合、pcbHash には pbHash に割り当てるバイト数が含まれます。

[in] pbHash

ハッシュを受け取る BYTE バッファーへのポインター。 このパラメーターが NULL として渡された場合、 pcbHash には pbHash に割り当てるバイト数が含まれており、後続の呼び出しを行ってハッシュを取得できます。

[in] dwFlags

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

戻り値

関数が成功した場合、戻り値は TRUE です。関数が失敗した場合は FALSE 。 FALSE が返された場合は、GetLastError 関数を呼び出して、エラーの原因を特定します。 pbHash に十分なメモリが割り当てられていない場合、CryptCATAdminCalcHashFromFileHandle 関数は最後のエラーをERROR_INSUFFICIENT_BUFFERに設定します。

要件

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