WaitForDebugEvent info Overview Group

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.

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.

Only the thread that created the process being debugged can call WaitForDebugEvent.