PowerWriteSettingAttributes 函式 (powrprof.h)

設定電源索引鍵的電源屬性。如果 PowerSettingGuid 參數為 NULL ， 則會設定 SubGroupGuid 的屬性，否則會設定 PowerSettingGuid 的屬性。

語法

DWORD PowerWriteSettingAttributes(
  [in] const GUID *SubGroupGuid,
  [in] const GUID *PowerSettingGuid,
  [in] DWORD      Attributes
);

[in] SubGroupGuid

電源設定的子群組。此參數可以是 WinNT.h 中定義的下列其中一個值。使用 NO_SUBGROUP_GUID 來參考預設電源配置。

值	意義
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	此子群組中的設定是預設電源配置的一部分。
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	此子群組中的設定可控制系統硬碟的電源管理組態。
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	此子群組中的設定可控制系統電源按鈕的組態。
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	此子群組中的設定可控制處理器電源管理功能的組態。
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	此子群組中的設定可控制視訊電源管理功能的組態。
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	此子群組中的設定可控制電池警示車程點和動作。
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	此子群組控制系統睡眠設定中的設定。
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	此子群組中的設定會控制PCI Express設定。

[in] PowerSettingGuid

電源設定的標識碼。

[in] Attributes

要與指定電源設定相關聯的屬性。

值	意義
POWER_ATTRIBUTE_HIDE 1	隱藏此電源設定。

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

在您呼叫 PowerSetActiveScheme 函式之前，作用中電源配置的設定變更不會生效。