PowerWriteFriendlyName 関数 (powrprof.h)

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

構文

DWORD PowerWriteFriendlyName(
  [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

ワイド (Unicode) 文字のフレンドリ名。

[in] BufferSize

Buffer パラメーターで指定されたフレンドリ名のサイズ (終端の NULL 文字を含む)。

戻り値

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

注釈

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

要件

こちらもご覧ください

Power Management Functions