ImageGetDigestStream 関数 (imagehlp.h)

指定したイメージ ファイルから要求されたデータを取得します。

構文

BOOL IMAGEAPI ImageGetDigestStream(
  [in] HANDLE          FileHandle,
  [in] DWORD           DigestLevel,
  [in] DIGEST_FUNCTION DigestFunction,
  [in] DIGEST_HANDLE   DigestHandle
);

パラメーター

[in] FileHandle

イメージ ファイルへのハンドル。 このハンドルは、FILE_READ_DATAアクセスのために開く必要があります。

[in] DigestLevel

返されるデータ ストリームに含めるイメージの側面。 このパラメーターには、次の 1 つ以上の値を指定できます。

[in] DigestFunction

データを処理するコールバック ルーチンへのポインター。 詳細については、「 DigestFunction」を参照してください。

[in] DigestHandle

ダイジェストへのユーザー指定のハンドル。 このパラメーターは、最初の引数として DigestFunction に渡されます。

戻り値

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報を取得するには、 GetLastError を呼び出します。

注釈

ImageGetDigestStream 関数は、渡された DigestLevel パラメーターに従って、指定されたイメージ ファイルからダイジェストされるデータを返します。 バイトの順序は、異なる呼び出しに対して一貫しています。これは、取得したバイト ストリームから常に同じメッセージ ダイジェストが生成されるようにするために必要です。

クロスプラットフォームの互換性を確保するために、この関数のすべての実装は、イメージ ファイルのさまざまな部分が返される順序に関して一貫した方法で動作する必要があります。

データは次の順序で返される必要があります。

1. 画像 (実行可能ファイルと静的データ) 情報。
2. リソース データ。
3. デバッグ情報。

この関数など、すべての ImageHlp 関数はシングル スレッドです。 そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。 これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。

要件

こちらもご覧ください

ImageHlp 関数