StackTraceNext

3.1

  #include <toolhelp.h>    

  BOOL StackTraceNext(lpste)    
  STACKTRACEENTRY FAR* lpste; /* address of stack-frame structure */

The StackTraceNext function fills the specified structure with information that describes the next stack frame in a stack trace.

Parameters

lpste

Points to a STACKTRACEENTRY structure to receive information about the next stack frame. The STACKTRACEENTRY structure has the following form:

#include <toolhelp.h>

typedef struct tagSTACKTRACEENTRY {  /* ste */
    DWORD   dwSize;
    HTASK   hTask;
    WORD    wSS;
    WORD    wBP;
    WORD    wCS;
    WORD    wIP;
    HMODULE hModule;
    WORD    wSegment;
    WORD    wFlags;
} STACKTRACEENTRY;

For a full description of this structure, see the Microsoft Windows Programmer's Reference, Volume 3.

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.

Comments

The StackTraceNext function can be used to continue a stack trace started by using the StackTraceFirst or StackTraceCSIPFirst function.

See Also

StackTraceCSIPFirst, StackTraceFirst, STACKTRACEENTRY