PowerReadPossibleValue 関数 (powrprof.h)
電源設定の有効な値の値を取得します。
構文
DWORD PowerReadPossibleValue(
[in, optional] HKEY RootPowerKey,
[in, optional] const GUID *SubGroupOfPowerSettingsGuid,
[in, optional] const GUID *PowerSettingGuid,
[out, optional] PULONG Type,
[in] ULONG PossibleSettingIndex,
[out, optional] PUCHAR Buffer,
[in, out] LPDWORD BufferSize
);
パラメーター
[in, optional] RootPowerKey
このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。
[in, optional] SubGroupOfPowerSettingsGuid
電源設定のサブグループ。 このパラメーターには、WinNT.h で定義されている次のいずれかの値を指定できます。 NO_SUBGROUP_GUIDを使用して、既定の電源スキームを参照します。
[in, optional] PowerSettingGuid
電源設定の識別子。
[out, optional] Type
値のデータ型を受け取る変数へのポインター。 使用できる値については、「 レジストリ値の種類」を参照してください。 このパラメーターは NULL にすることができ、データの型は返されません。
[in] PossibleSettingIndex
指定できる設定の 0 から始まるインデックス。
[out, optional] Buffer
値を受け取るバッファーへのポインター。 このパラメーターが NULL の場合、 BufferSize パラメーターは必要なバッファー サイズを受け取ります。
[in, out] BufferSize
Buffer パラメーターによって指されるバッファーのサイズを含む変数へのポインター。
Buffer パラメーターが NULL の場合、関数は ERROR_SUCCESSを返し、変数は必要なバッファー サイズを受け取ります。
指定したバッファー サイズが、要求されたデータを保持するのに十分な大きさでない場合、関数は ERROR_MORE_DATA を返し、変数は必要なバッファー サイズを受け取ります。
戻り値
呼び出 しが 成功した場合はERROR_SUCCESS (0) を返し、呼び出しが失敗した場合は 0 以外の値を返します。 BufferSize パラメーターで指定されたバッファー サイズが小さすぎる場合は、
ERROR_MORE_DATAが返され、BufferSize パラメーターが指す DWORD に必要なバッファー サイズが入力されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | powrprof.h |
| Library | PowrProf.lib |
| [DLL] | PowrProf.dll |