powerClearRequest 函式 (winbase.h)

遞減電源要求物件指定類型的電源要求計數。

語法

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

電源要求物件的句柄。

[in] RequestType

要遞減的電源要求類型。此參數可以是下列其中一個值。

值	意義
PowerRequestDisplayRequired	即使長時間沒有使用者輸入，顯示器仍會保持開啟狀態。
PowerRequestSystemRequired	系統會在使用者閑置期間後繼續執行，而不是進入睡眠狀態。
PowerRequestAwayModeRequired	系統會進入離開模式，而不是睡眠。在離開模式中，系統會繼續執行，但關閉音訊和視訊，以提供睡眠的外觀。
PowerRequestExecutionRequired	呼叫進程會繼續執行，而不是由進程存留期管理機制暫停或終止。允許進程執行的時間和時間取決於操作系統和電源原則設定。當 PowerRequestExecutionRequired 要求作用中時，表示 PowerRequestSystemRequired。 PowerRequestExecutionRequired 要求類型只能由應用程式使用。服務無法使用此要求類型。 Windows 7 和 Windows Server 2008 R2：從 Windows 8 和 Windows Server 2012 開始，支援此要求類型。

如果函式成功，則會傳回非零值。

如果函式失敗，則會傳回零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。