SymGetFileLineOffsets64 function (dbghelp.h)

Locates line information for the specified module and file name.

Syntax

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

Parameters

[in] hProcess

A handle to the process that was originally passed to the SymInitialize function.

[in, optional] ModuleName

The name of the module in which lines are to be located. If this parameter is NULL, the function searches all modules.

[in] FileName

The name of the file in which lines are to be located.

[out] Buffer

An array of offsets for each line. The offset for the line n is stored in element n-1. Array elements for lines that do not have line information are left unchanged.

[in] BufferLines

The size of the Buffer array, in elements.

Return value

If the function succeeds, the return value is the highest line number found. This value is zero if no line information was found.

If the function fails, the return value is LINE_ERROR. To retrieve extended error information, call GetLastError.

Remarks

All DbgHelp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.

Requirements

Requirement Value
Target Platform Windows
Header dbghelp.h
Library Dbghelp.lib
DLL Dbghelp.dll
Redistributable DbgHelp.dll 5.1 or later

See also

DbgHelp Functions