SymGetLineNext

The SymGetLineNext function retrieves the line information for the next source line.

This function is implemented as a wrapper that calls SymGetLineNext64. For more information, see New 64-bit Functions.

BOOL SymGetLineNext(
  HANDLE hProcess,
  PIMAGEHLP_LINE Line
);

For SymGetLineNext64, the parameter list is as follows.

BOOL SymGetLineNext64(
  HANDLE hProcess,
  PIMAGEHLP_LINE64 Line
);

Parameters

hProcess

[in] Handle to the process that was originally passed to the SymInitialize function.

Line

[in/out] Pointer to an IMAGEHLP_LINE structure that contains the line information.

Return Value

If the function succeeds, the return value is TRUE.

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

Remarks

The SymGetLineNext function requires that the IMAGEHLP_LINE structure have valid data, presumably obtained from a call to the SymGetLineFromAddr or SymGetLineFromName function. This structure receives the line information for the next line in sequence.

Requirements

  Windows NT/2000: Requires Windows 2000. Available as a redistributable for Windows NT 4.0.
  Windows 95/98: Requires Available as a redistributable for Windows 98.
  Header: Declared in Dbghelp.h.
  Library: Use Dbghelp.lib.

See Also

Debug Help Library Overview, DbgHelp Functions, IMAGEHLP_LINE, SymGetLineFromAddr, SymGetLineFromName, SymGetLinePrev, SymInitialize