OpenWatchDogTimer (Compact 2013)

  • Article

3/28/2014

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

See Also

Reference

Kernel Functions
WaitForSingleObject
WaitForMultipleObjects
CreateWatchDogTimer
StartWatchDogTimer
StopWatchDogTimer
RefreshWatchDogTimer

Other Resources

CloseHandle