Método GetCallerAccessRights da classe __SystemSecurity

Artigo
07/03/2023

O método __SystemSecurity::GetCallerAccessRights define o parâmetro rights como um bitmap com cada bit correspondente a um direito de acesso. Qualquer cliente pode chamar esse método para determinar quais direitos o cliente tem. Esse método é útil para clientes que habilitam ou desabilitam recursos. Por exemplo, um aplicativo de GUI pode desabilitar um botão se o usuário conectado no momento não tiver direitos de execução de método.

Qualquer cliente habilitado tem o direito de chamar GetCallerAccessRights, mesmo que esse cliente não tenha direitos gerais de execução do método.

Sintaxe

HRESULT GetCallerAccessRights(
  [out] sint32 rights
);

Parâmetros

rights [saída]: Direitos de acesso do cliente. Para obter mais informações, consulte __SystemSecurity e Constantes de segurança do WMI.
WBEM_ENABLE (1 (0x1)): Habilita a conta e concede ao usuário permissões de leitura. Esse é o direito de acesso padrão para todos os usuários.
WBEM_METHOD_EXECUTE (2 (0x2)): Permite a execução de métodos.

Observação

Os provedores podem executar verificações de acesso adicionais.
WBEM_FULL_WRITE_REP (4 (0x4)): Permite que o chamador, o contexto de segurança ou o usuário grave em classes e instâncias, exceto nas classes do sistema.
WBEM_PARTIAL_WRITE_REP (8 (0x8)): Permite que o chamador, o contexto de segurança ou o usuário grave instâncias do provedor, mas não em classes estáticas ou instâncias estáticas no repositório.
WBEM_WRITE_PROVIDER (16 (0x10)): Permite que o chamador, o contexto de segurança ou o usuário grave classes e instâncias em provedores.

Observação

A representação de provedores pode fazer outras verificações de acesso.
WBEM_REMOTE_ACCESS (32 (0x20)): Permite que uma conta de usuário execute remotamente qualquer operação permitida pelas permissões definidas por outros bits.
READ_CONTROL (131072 (0x20000)): Permite o acesso de leitura aos descritores de segurança.
WRITE_DAC (262144 (0x40000)): Permite o acesso de gravação à DACL (listas de controle de acesso discricionário).

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista os valores retornados de significância para Set9XUserList. Para scripts e aplicativos do Visual Basic, o resultado pode ser obtido de OutParameters.ReturnValue. Para obter mais informações, veja Construir objetos InParameters e Analisar objetos OutParameters.

WBEM_E_METHOD_DISABLED: Esse método não é compatível com versões com suporte do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Todos os namespaces do WMI

Confira também

Classes de sistema do WMI
__SystemSecurity
__SystemSecurity::GetSD
__SystemSecurity::SetSD
Constantes de segurança do WMI
Win32_ACE
Win32_SecurityDescriptor
Como proteger namespaces do WMI
Constantes de segurança do WMI

Share via