PowerSettingRegisterNotification 函式 (powersetting.h)

  • 發行項

註冊以在電源設定變更時接收通知。

語法

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

參數

[in] SettingGuid

表示電源設定的 GUID。

[in] Flags

通知收件者的相關信息。 此參數可以是下列其中一個值：

值 意義
DEVICE_NOTIFY_SERVICE_HANDLE
 Recipient 參數是服務的句柄。 使用 CreateService 或 OpenService 函式來取得此句柄。
DEVICE_NOTIFY_CALLBACK
 Recipient 參數是當電源設定變更時要呼叫的回呼函式指標。 在此情況下，收件者必須是類型PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS。

[in] Recipient

通知收件者的句柄。

[out] RegistrationHandle

註冊的句柄。 使用此句柄取消註冊通知。

傳回值

如果呼叫成功，則傳回ERROR_SUCCESS (零) ，如果呼叫失敗，則傳回非零值。

備註

在註冊之後，將會使用電源設定的目前值來叫用回呼。 如果在電源設定變更時發生註冊，您可能會收到多個回呼;最後一個回呼是最新的更新。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 powersetting.h
程式庫 Powrprof.lib
Dll Powrprof.dll

另請參閱

電源設定 GUID

PowerSettingUnregisterNotification