SymGetSymPrev

The SymGetSymPrev function retrieves the symbol information of the previous symbol.

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

BOOL SymGetSymPrev(
  HANDLE hProcess,             
  PIMAGEHLP_SYMBOL Symbol  
);

For SymGetSymNext64, the parameter list is as follows.

BOOL SymGetSymPrev64(
  HANDLE hProcess,             
  PIMAGEHLP_SYMBOL64 Symbol  
);

Parameters

hProcess

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

Symbol

[in/out] Pointer to an IMAGEHLP_SYMBOL structure.

Return Values

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 SymGetSymPrev function requires the IMAGEHLP_SYMBOL structure to have valid data, presumably obtained from a call to the SymGetSymFromAddr or SymGetSymFromName function. This structure is filled in with the symbol information for the previous symbol in sequence by virtual address.

Requirements

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

See Also

Debug Help Library Overview, DbgHelp Functions, IMAGEHLP_SYMBOL, SymGetSymFromAddr, SymGetSymFromName, SymGetSymNext, SymInitialize