Функция PowerReadPossibleFriendlyName (powrprof.h)
Извлекает понятное имя для одного из возможных вариантов значения параметров питания.
DWORD PowerReadPossibleFriendlyName(
[in, optional] HKEY RootPowerKey,
[in, optional] const GUID *SubGroupOfPowerSettingsGuid,
[in, optional] const GUID *PowerSettingGuid,
[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
Идентификатор параметра питания.
[in] PossibleSettingIndex
Отсчитываемый от нуля индекс для возможного параметра.
[out, optional] Buffer
Указатель на буфер, получающий понятное имя. Если этот параметр имеет значение NULL, параметр BufferSize получает требуемый размер буфера. Возвращаемые строки являются широкими строками (Юникод).
[in, out] BufferSize
Указатель на переменную, содержащую размер буфера, на который указывает параметр Buffer .
Если параметр Buffer имеет значение NULL, функция возвращает ERROR_SUCCESS, а переменная получает требуемый размер буфера.
Если указанный размер буфера недостаточно велик для хранения запрошенных данных, функция возвращает ERROR_MORE_DATA , а переменная получает требуемый размер буфера.
Возвращает ERROR_SUCCESS (ноль), если вызов был выполнен успешно, и ненулевое значение, если вызов завершился неудачно. Если размер буфера, указанный параметром BufferSize , слишком мал,
ERROR_MORE_DATA будет возвращено, а параметр DWORD , на который указывает параметр BufferSize , будет заполнен требуемым размером буфера.
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | powrprof.h |
Библиотека | PowrProf.lib |
DLL | PowrProf.dll |