powerCreateRequest 函式 (winbase.h)

建立新的電源要求物件。

語法

HANDLE PowerCreateRequest(
  [in] PREASON_CONTEXT Context
);

[in] Context

指向包含電源要求相關資訊的REASON_CONTEXT 結構。

如果函式成功，則傳回值是電源要求物件的控制碼。

如果此函數失敗，傳回值就是 INVALID_HANDLE_VALUE。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

不再需要電源要求物件時，請使用 CloseHandle 函式釋放控制碼並清除物件。