SymGetFileLineOffsets64 関数 (dbghelp.h)

指定したモジュールとファイル名の行情報を検索します。

構文

ULONG IMAGEAPI SymGetFileLineOffsets64(
  [in]           HANDLE   hProcess,
  [in, optional] PCSTR    ModuleName,
  [in]           PCSTR    FileName,
  [out]          PDWORD64 Buffer,
  [in]           ULONG    BufferLines
);

パラメーター

[in] hProcess

SymInitialize 関数に最初に渡されたプロセスのハンドル。

[in, optional] ModuleName

行が配置されるモジュールの名前。 このパラメーターが NULL の場合、関数はすべてのモジュールを検索します。

[in] FileName

行が配置されるファイルの名前。

[out] Buffer

各行のオフセットの配列。 n 行目のオフセットは、要素 n-1 に格納されます。 行情報を持たない行の配列要素は変更されません。

[in] BufferLines

Buffer 配列のサイズ (要素単位)。

戻り値

関数が成功した場合、戻り値は見つかった最も大きい行番号になります。 行情報が見つからなかった場合、この値は 0 です。

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

注釈

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

要件

こちらもご覧ください

DbgHelp 関数