Função PowerReadDescription (powrprof.h)
Recupera a descrição da configuração de energia, subgrupo ou esquema especificado. Se o parâmetro SchemeGuid não for NULL , mas os parâmetros SubGroupOfPowerSettingsGuid e PowerSettingGuid forem NULL, a descrição do esquema de energia será retornada. Se os parâmetros SchemeGuid e SubGroupOfPowerSettingsGuid não forem NULL e o parâmetro PowerSettingGuid for NULL, a descrição do subgrupo será retornada. Se os parâmetros SchemeGuid, SubGroupOfPowerSettingsGuid e PowerSettingGuid não forem NULL, a descrição da configuração de energia será retornada.
Sintaxe
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
);
Parâmetros
[in, optional] RootPowerKey
Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.
[in, optional] SchemeGuid
O identificador do esquema de energia.
[in, optional] SubGroupOfPowerSettingsGuid
O subgrupo de configurações de energia. Esse parâmetro pode ser um dos seguintes valores definidos em WinNT.h. Use NO_SUBGROUP_GUID para se referir ao esquema de energia padrão.
[in, optional] PowerSettingGuid
O identificador da configuração de energia que está sendo usada.
[out, optional] Buffer
Um ponteiro para um buffer que recebe a descrição. Se esse parâmetro for NULL, o parâmetro BufferSize receberá o tamanho do buffer necessário. As cadeias de caracteres retornadas são todas cadeias de caracteres largas (Unicode).
[in, out] BufferSize
Um ponteiro para uma variável que contém o tamanho do buffer apontado pelo parâmetro Buffer .
Se o parâmetro Buffer for NULL, a função retornará ERROR_SUCCESS e a variável receberá o tamanho do buffer necessário.
Se o tamanho do buffer especificado não for grande o suficiente para conter os dados solicitados, a função retornará ERROR_MORE_DATA e a variável receberá o tamanho do buffer necessário.
Retornar valor
Retornará ERROR_SUCCESS (zero) se a chamada tiver sido bem-sucedida e um valor diferente de zero se a chamada falhar. Se o tamanho do buffer especificado pelo parâmetro BufferSize for muito pequeno, a função retornará ERROR_SUCCESS e o DWORD apontado pelo parâmetro BufferSize será preenchido com o tamanho do buffer necessário.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | powrprof.h |
Biblioteca | PowrProf.lib |
DLL | PowrProf.dll |