共用方式為

PowerReadSettingAttributes 函式 (powrprof.h)

  • 發行項

傳回指定之電源設定的目前屬性。 如果 SubGroupGuid 參數為 NULL ，則會傳回 PowerSettingGuid 的屬性。 如果 PowerSettingGuid 參數為 NULL ，則會傳回 SubGroupGuid 的屬性。 如果 SubGroupGuid 和 PowerSettingGuid 參數都有效，則傳回值會是子群組屬性和電源設定 (位 OR) 的組合。

語法

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

參數

[in] SubGroupGuid

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

這些值是 Windows 隨附的子群組值。

值 意義
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

正在使用之電源設定的識別碼。

傳回值

傳回指定電源設定的目前電源設定屬性。 屬性是電源設定的屬性和其子群組屬性的組合。

傳回碼/值 Description
POWER_ATTRIBUTE_HIDE
1
 隱藏此電源設定。

規格需求

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

另請參閱

電源管理功能