ホーム › System.Diagnostics.Debug › PFIND_DEBUG_FILE_CALLBACKW

PFIND_DEBUG_FILE_CALLBACKW

コールバック

シグネチャ

BOOL PFIND_DEBUG_FILE_CALLBACKW(
    HANDLE FileHandle,
    LPWSTR FileName,
    void* CallerData
);

パラメーター

フィールド	型	説明
FileHandle	HANDLE	シンボルファイルのハンドル。
FileName	LPWSTR	シンボルファイルの名前。
CallerData	void*	省略可能なユーザー定義のデータ。このパラメーターは NULL でもかまいません。

公式ドキュメント

FindDebugInfoFileEx 関数と共に使用されるアプリケーション定義のコールバック関数です。 FindDebugInfoFileEx が見つけたシンボルファイルが正しいシンボルファイルかどうかを検証します。

PFIND_DEBUG_FILE_CALLBACK 型および PFIND_DEBUG_FILE_CALLBACKW 型は、このコールバック関数へのポインターを定義します。 FindDebugInfoFileProc は、アプリケーション定義の関数名のプレースホルダーです。

戻り値

シンボルファイルが有効な場合は TRUE を返します。それ以外の場合は FALSE を返します。

解説(Remarks)

シンボルファイルを検証する方法の 1 つは、そのタイムスタンプをイメージ内のタイムスタンプと比較することです。イメージのタイムスタンプを取得するには、 GetTimestampForLoadedLibrary 関数を使用します。シンボルファイルのタイムスタンプを取得するには、 SymGetModuleInfo64 関数を使用します。

メモ

dbghelp.h ヘッダーは、PFIND_DEBUG_FILE_CALLBACK を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義します。エンコーディングに依存しないエイリアスを、エンコーディングに依存するコードと混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)