SymGetSymNext

The SymGetSymNext function retrieves the symbol information of the next symbol.

BOOL SymGetSymNext(
  IN HANDLE hProcess,             
  IN OUT PIMAGEHLP_SYMBOL Symbol  
);
 

Parameters

hProcess

Handle to the process that was originally passed to the SymInitialize function.

Symbol

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

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in imagehlp.h.
  Import Library: Use imagehlp.lib.

See Also

PE Image Helper (ImageHlp) Overview, Symbol Handler, IMAGEHLP_SYMBOL, SymGetSymFromAddr, SymGetSymFromName, SymGetSymPrev, SymInitialize