CancelDeviceWakeupRequest

[This is preliminary documentation and subject to change.]

The CancelDeviceWakeupRequest function cancels a device wake-up request issued previously by the RequestDeviceWakeup function.

BOOL CancelDeviceWakeupRequest(
  HANDLE hDevice   // handle to object or device
);
 

Parameters

hDevice

Handle to an object on the device, such as a file or socket, or a handle to the device itself.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. The function will fail if the device does not support wake-up or if the system is entering the sleeping state.

Remarks

The wake-up functionality may not be turned off immediately. The system will only disable the wake-up feature on the device when all applications that requested wake-up on that device using the RequestDeviceWakeup function have canceled their requests using CancelWakeupRequest.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in winbase.h.
  Import Library: Use kernel32.lib.

See Also

Power Management Overview, Power Management Functions, RequestDeviceWakeup