The WaitForDebugEvent function waits for a debugging event to occur in a process being debugged.
BOOL WaitForDebugEvent(
| LPDEBUG_EVENT lpDebugEvent, | // address of structure for event information |
| DWORD dwMilliseconds | // number of milliseconds to wait for event |
| ); |
Parameters
lpDebugEvent
Points to a DEBUG_EVENT structure that is filled with information about the debugging event.
dwMilliseconds
Specifies the number of milliseconds to wait for a debugging event. If this parameter is zero, the function tests for a debugging event and returns immediately. If the parameter is INFINITE, the function does not return until a debugging event has occurred.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
Only the thread that created the process being debugged can call WaitForDebugEvent.
See Also
ContinueDebugEvent, DebugActiveProcess, DebugBreak, DEBUG_EVENT, OutputDebugString