SymNext 関数 (dbghelp.h)

次のシンボルのシンボル情報を取得します。

構文

BOOL IMAGEAPI SymNext(
  [in]      HANDLE       hProcess,
  [in, out] PSYMBOL_INFO si
);

[in] hProcess

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

[in, out] si

現在のシンボルに関する情報を提供する SYMBOL_INFO 構造体へのポインター。返されると、構造体には次のシンボルに関する情報が含まれます。

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

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

この関数では、 SYMBOL_INFO 構造体に現在のシンボルの有効なデータが必要です。次のシンボルは、シーケンス内の次の仮想アドレスを持つシンボルです。

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

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