PowerWriteIconResourceSpecifier 関数 (powrprof.h)

指定した電源設定、サブグループ、またはスキームのアイコン リソースを設定します。

構文

DWORD PowerWriteIconResourceSpecifier(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

パラメーター

[in, optional] RootPowerKey

このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。

[in] SchemeGuid

電源スキームの識別子。

[in, optional] SubGroupOfPowerSettingsGuid

電源設定のサブグループ。 このパラメーターには、WinNT.h で定義されている次のいずれかの値を指定できます。 NO_SUBGROUP_GUIDを使用して、既定の電源スキームを参照します。

[in, optional] PowerSettingGuid

電源設定の識別子。

[in] Buffer

アイコン リソース。

[in] BufferSize

Buffer パラメーターが指すバッファーのサイズ。

戻り値

呼 び出しが成功した 場合はERROR_SUCCESS (ゼロ) を返し、呼び出しが失敗した場合は 0 以外の値を返します。

注釈

SchemeGuid パラメーターが NULL ではなく、SubGroupOfPowerSettingsGuid パラメーターと PowerSettingGuid パラメーターの両方が NULL の場合、電源スキームのフレンドリ名が設定されます。 SchemeGuid パラメーターと SubGroupOfPowerSettingsGuid パラメーターが NULL ではなく、PowerSettingGuid パラメーターが NULL の場合、サブグループのフレンドリ名が設定されます。 SchemeGuid、SubGroupOfPowerSettingsGuid、および PowerSettingGuid パラメーターが NULL でない場合は、電源設定のフレンドリ名が設定されます。

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

要件

こちらもご覧ください

Power Management Functions