SymFromAddr 関数 (dbghelp.h)

指定したアドレスのシンボル情報を取得します。

構文

BOOL IMAGEAPI SymFromAddr(
  [in]            HANDLE       hProcess,
  [in]            DWORD64      Address,
  [out, optional] PDWORD64     Displacement,
  [in, out]       PSYMBOL_INFO Symbol
);

パラメーター

[in] hProcess

プロセスへのハンドル。 このハンドルは、 SymInitialize 関数に以前に渡されている必要があります。

[in] Address

シンボルを配置する必要があるアドレス。 アドレスはシンボル境界上にある必要はありません。 アドレスがシンボルの先頭の後、およびシンボルの末尾の前にある場合は、シンボルが見つかります。

[out, optional] Displacement

記号の先頭からの変位(0)。

[in, out] Symbol

シンボルに関する情報を提供する SYMBOL_INFO 構造体へのポインター。 シンボル名は可変長です。そのため、このバッファーは、 SYMBOL_INFO 構造体の末尾に格納されている名前を保持するのに十分な大きさにする必要があります。 MaxNameLen メンバーには、名前用に予約されているバイト数を必ず設定してください。

戻り値

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

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

注釈

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

この関数の Unicode バージョンを呼び出すには、DBGHELP_TRANSLATE_TCHARを定義します。

例

例については、「アドレスによるシンボル情報の取得」をご覧ください。

要件

こちらもご覧ください

DbgHelp 関数

SYMBOL_INFO