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 (0) を返し、呼び出しが失敗した場合は 0 以外の値を返します。

アクティブな電源スキームの設定に対する変更は、 PowerSetActiveScheme 関数を呼び出すまで有効になりません。