SymFromAddrW 関数 (dbghelp.h)
指定したアドレスのシンボル情報を取得します。
構文
BOOL IMAGEAPI SymFromAddrW(
[in] HANDLE hProcess,
[in] DWORD64 Address,
[out, optional] PDWORD64 Displacement,
[in, out] PSYMBOL_INFOW Symbol
);
パラメーター
[in] hProcess
プロセスへのハンドル。 このハンドルは、SymInitialize 関数に渡しておく必要があります。
[in] Address
シンボルを配置する必要があるアドレス。 アドレスはシンボル境界に存在する必要はありません。 アドレスがシンボルの先頭の後、シンボルの末尾の前にある場合は、シンボルが見つかります。
[out, optional] Displacement
記号の先頭からの変位。0。
[in, out] Symbol
シンボルに関する情報を提供する SYMBOL_INFO 構造体へのポインター。 シンボル名は可変長です。したがって、このバッファーは、SYMBOL_INFO 構造体の末尾に格納されている名前を保持するのに十分な大きさにする必要があります。 MaxNameLen メンバーには、名前用に予約されたバイト数を必ず設定してください。
戻り値
関数が成功した場合、戻り値は TRUE
関数が失敗した場合、戻り値は FALSE
備考
この関数など、すべての DbgHelp 関数はシングル スレッドです。 そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。 これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。
この関数の Unicode バージョンを呼び出すには、DBGHELP_TRANSLATE_TCHARを定義します。
例
例については、「アドレスによるシンボル情報の取得」を参照してください。
手記
dbghelp.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SymFromAddr を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | dbghelp.h |
ライブラリ | Dbghelp.lib |
DLL | Dbghelp.dll |
再頒布可能パッケージの | DbgHelp.dll 5.1 以降 |
関連項目
DbgHelp 関数 の