powerCreateRequest 函数 (winbase.h)

创建新的电源请求对象。

语法

HANDLE PowerCreateRequest(
  [in] PREASON_CONTEXT Context
);

参数

[in] Context

指向包含有关电源请求信息的 REASON_CONTEXT 结构。

返回值

如果函数成功,则返回值是电源请求对象的句柄。

如果函数失败,则返回值为 INVALID_HANDLE_VALUE。 要获得更多的错误信息,请调用 GetLastError。

注解

当不再需要电源请求对象时,请使用 CloseHandle 函数释放句柄并清理对象。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

PowerClearRequest

PowerSetRequest