Compartilhar via

Função PowerSettingAccessCheckEx (powrprof.h)

  • Artigo

Consultas para uma substituição de política de grupo para configurações de energia especificadas e especifica o acesso solicitado para a configuração.

Sintaxe

DWORD PowerSettingAccessCheckEx(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid,
  [in]           REGSAM              AccessType
);

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 de 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.

[in] AccessType

O tipo de acesso de segurança para a configuração. Para obter mais informações, consulte Segurança de Chave do Registro e Direitos de Acesso.

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
KEY_READ
 Combina os valores STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS e KEY_NOTIFY.
KEY_WRITE
 Combina os direitos de acesso STANDARD_RIGHTS_WRITE, KEY_SET_VALUE e KEY_CREATE_SUB_KEY.

Retornar valor

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

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho powrprof.h
Biblioteca Powrprof.lib
DLL Powrprof.dll