SymGetSymNext

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

BOOL SymGetSymNext(

IN HANDLE hProcess,  
IN OUT PIMAGEHLP_SYMBOL Symbol  
);  

Parameters

hProcess

The process handle that was originally passed to SymInitialize.

Symbol

A pointer to an IMAGEHLP_SYMBOL structure.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, then 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 SymGetSymFromAddr or SymGetSymFromName. This structure is filled in with the symbol information for the next symbol in sequence by virtual address.

Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.