OpenWatchDogTimer (Windows CE 5.0)
This function opens an existing watchdog timer.
HANDLEOpenWatchDogTimer(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 0.
Return Values
A handle to the watchdog timer indicates success.
NULL indicates failure.
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.
Remarks
A monitor process usually uses OpenWatchDogTimer to retrieve the handle to the watchdog timer of a critical process so it can monitor the critical processes by waiting on the watchdog handles.
OpenWatchDogTimer is a trusted API because it gives you the ability to reset the device. Only trusted applications can access this function. For more information, see Trusted APIs.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Pkfuncs.h.
Link Library: Coredll.lib.
See Also
WaitForSingleObject | WaitForMultipleObjects | CloseHandle | CreateWatchDogTimer | StartWatchDogTimer | StopWatchDogTimer | RefreshWatchDogTimer
Send Feedback on this topic to the authors