OpenWatchDogTimer (Windows Embedded CE 6.0)
1/6/2010
This function opens an existing watchdog timer.
Syntax
HANDLE OpenWatchDogTimer(
LPCWSTR pszWatchDogName,
DWORD dwFlags
);
Parameters
- pszWatchDogName
[in] Name of the watchdog timer to open. Each object type, such as memory maps, semaphores, events, message queues, mutexes, and watchdog timers, has its own separate namespace. Empty strings ("") are handled as named objects. On Windows desktop-based platforms, synchronization objects all share the same namespace.
- dwFlags
[in] Reserved; must be set to zero.
Return Value
A handle to the watchdog timer indicates success. NULL indicates failure.
Remarks
The handle returned can be used in WaitForSingleObject or WaitForMultipleObjects and is signaled when the watchdog is not refreshed within the specified watchdog period, dwPeriod.
Use the CloseHandle function to release the memory used by the watchdog timer.
A monitor process usually uses OpenWatchDogTimer to obtain the handle to the watchdog timer of a critical process so that it can monitor the critical processes by waiting for watchdog handles.
Requirements
| Header | pkfuncs.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
See Also
Reference
Kernel Functions
CreateWatchDogTimer
StartWatchDogTimer
StopWatchDogTimer
RefreshWatchDogTimer