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 関数を呼び出すまで有効になりません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | powrprof.h |
| Library | PowrProf.lib |
| [DLL] | PowrProf.dll |