WaitForDebugEvent

This function waits for a debugging event to occur in a process being debugged.

BOOL WaitForDebugEvent(
LPDEBUG_EVENT lpDebugEvent, 
DWORD dwMilliseconds );

Parameters

  • lpDebugEvent
    Pointer 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

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

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

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.0 and later Winbase.h   Coredll.lib, Nk.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

ContinueDebugEvent, DebugActiveProcess, DebugBreak, GetLastError, OutputDebugString, DEBUG_EVENT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.