Compartilhar via


Função PowerSettingAccessCheck (powrprof.h)

Consultas para uma substituição de política de grupo para configurações de energia especificadas.

Sintaxe

DWORD PowerSettingAccessCheck(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid
);

Parâmetros

[in] AccessFlags

O tipo de acesso a marcar para substituições de política de grupo.

Valor Significado
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
Verifique se há substituições nas configurações de energia do AC.
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
Verifique se há substituições nas configurações de energia do DC.
ACCESS_SCHEME
16 (0x10)
Verifique se há restrições em esquemas de energia específicos.
ACCESS_ACTIVE_SCHEME
19 (0x13)
Verifique se há restrições em esquemas de energia ativos.
ACCESS_CREATE_SCHEME
20 (0x14)
Verifique se há restrições na criação ou restauração de esquemas de energia.

[in, optional] PowerGuid

O identificador da configuração de energia.

Valor retornado

Retornará ERROR_SUCCESS (zero) se a chamada tiver sido bem-sucedida e um valor diferente de zero se a chamada falhar.

Valor/código retornado Descrição
ERROR_SUCCESS
0 (0x0)
No momento, a configuração de energia especificada não é substituída por uma política de grupo.
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
Esse programa foi bloqueado pela política de grupo. Para obter mais informações, entre em contato com o administrador do sistema.
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
Somente os administradores podem acessar remotamente as configurações de energia.

Requisitos

   
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

Confira também

POWER_DATA_ACCESSOR

Funções de gerenciamento de energia