SymGetLinePrev

The SymGetLinePrev function retrieves the line information for the previous source line.

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

BOOL SymGetLinePrev(
  HANDLE hProcess,
  PIMAGEHLP_LINE Line
);

For SymGetLinePrev64, the parameter list is as follows.

BOOL SymGetLinePrev64(
  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.

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 SymGetLinePrev function requires that the IMAGEHLP_LINE structure have valid data, presumably obtained from a call to the SymGetLineFromAddr or SymGetLineFromName function. This structure is filled with the line information for the previous 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, SymGetLineNext, SymInitialize