SymGetFileLineOffsets64 Function

Debug Help Library

SymGetFileLineOffsets64 Function

Locates line information for the specified module and file name.

BOOL WINAPI SymGetFileLineOffsets64(
  __in          HANDLE hProcess,
  __in          PCSTR ModuleName,
  __in          PCSTR FileName,
  __out         PDWORD64 Buffer,
  __in          ULONG BufferLines
);

Parameters

hProcess

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

ModuleName

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

FileName

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

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.

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

Redistributable

Requires DbgHelp.dll 5.1 or later.

Header

Declared in Dbghelp.h.

Library

Use Dbghelp.lib.

DLL

Requires Dbghelp.dll.

See Also

DbgHelp Functions

Send comments about this topic to Microsoft

Build date: 9/25/2007

© 2007 Microsoft Corporation. All rights reserved.