共用方式為

PowerEnumerate 函式 (powrprof.h)

  • 發行項

列舉電源配置中的指定專案。 此函式通常會在迴圈中呼叫，以遞增 Index 參數來擷取子機碼，直到全部列舉為止。

語法

DWORD PowerEnumerate(
  [in, optional]  HKEY                RootPowerKey,
  [in, optional]  const GUID          *SchemeGuid,
  [in, optional]  const GUID          *SubGroupOfPowerSettingsGuid,
  [in]            POWER_DATA_ACCESSOR AccessFlags,
  [in]            ULONG               Index,
  [out, optional] UCHAR               *Buffer,
  [in, out]       DWORD               *BufferSize
);

參數

[in, optional] RootPowerKey

此參數保留供日後使用，且必須設定為 NULL。

[in, optional] SchemeGuid

電源配置的識別碼。 如果此參數為 NULL，則會傳回電源原則的列舉。

[in, optional] SubGroupOfPowerSettingsGuid

電源設定的子群組。 如果此參數為 NULL，則會傳回 PolicyGuid 索引鍵底下的設定列舉。

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

一組旗標，指定將列舉的內容

值 意義
ACCESS_SCHEME
16
 列舉電源配置。 將會忽略 SchemeGuid 和 SubgroupOfPowerSettingsGuid 參數。
ACCESS_SUBGROUP
17
 列舉 SchemeGuid 底下的子群組。 將會忽略 SubgroupOfPowerSettingsGuid 參數。
ACCESS_INDIVIDUAL_SETTING
18
 列舉 SchemeGuid\SubgroupOfPowerSettingsGuid 下的個別電源設定。 若要直接在 SchemeGuid 索引鍵下列舉電源設定，請使用 NO_SUBGROUP_GUID 作為 SubgroupOfPowerSettingsGuid 參數。

[in] Index

要列舉之配置、子群組或設定之以零起始的索引。

[out, optional] Buffer

要接收項目的變數指標。 如果此參數為 NULL，函式會擷取所需的緩衝區大小。

[in, out] BufferSize

輸入上變數的指標包含 Buffer 參數所指向的緩衝區大小。 如果 Buffer 參數為 NULL 或 BufferSize 不夠大，則函式會傳回ERROR_MORE_DATA，且變數會收到所需的緩衝區大小。

傳回值

如果呼叫成功，則傳回 ERROR_SUCCESS (零) ，如果呼叫失敗，則傳回非零值。 如果在 BufferSize 參數中傳遞的緩衝區大小太小，或是 Buffer 參數為NULL，則會傳回ERROR_MORE_DATA，且 BufferSize 參數所指向的 DWORD 將會填入所需的緩衝區大小。

規格需求

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

另請參閱

POWER_DATA_ACCESSOR

電源管理功能