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