SymFromName 関数 (dbghelp.h)

指定した名前のシンボル情報を取得します。

構文

BOOL IMAGEAPI SymFromName(
  [in]      HANDLE       hProcess,
  [in]      PCSTR        Name,
  [in, out] PSYMBOL_INFO Symbol
);

[in] hProcess

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

[in] Name

配置するシンボルの名前。

[in, out] Symbol

シンボルに関する情報を提供する SYMBOL_INFO 構造体へのポインター。

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

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

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

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

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