Método SetSecurityDescriptor da classe __SystemSecurity

O método SetSecurityDescriptor grava uma versão atualizada do descritor de segurança que controla o acesso ao namespace WMI ao qual você está conectado. O descritor de segurança é representado por uma instância de __SecurityDescriptor. Para obter mais informações, consulte Alterando a segurança de acesso em objetos protegíveis.

Sintaxe

uint32 SetSecurityDescriptor(
  [in] __SecurityDescriptor Descriptor
);

Parâmetros

Descritor [in]

O descritor de segurança associado ao Namespace WMI.

Valor de retorno

Retorna um dos valores listados na lista a seguir ou um valor diferente para indicar um erro. Para obter mais informações, consulte códigos de retorno WMI ou WbemErrorEnum.

0

Conclusão bem-sucedida.

2

O usuário não tem acesso às informações solicitadas.

8

Falha desconhecida.

9

O usuário não tem privilégios adequados para executar o método.

21

Um parâmetro especificado na chamada de método não é válido.

Observações

A instância Win32_SecurityDescriptor representa um tipo de dados SECURITY_DESCRIPTOR_CONTROL e contém uma DACL (lista de controle de acesso discricionário ) e uma SACL ( Lista de Controle de Acesso do Sistema ). Para obter mais informações, consulte Listas de Controle de Acesso.

Se o SeSecurityPrivilege não for concedido ou habilitado ao obter um descritor de segurança, somente a DACL será retornada no descritor de segurança retornado. Para obter mais informações, consulte As Constantes de Privilégios e a Execução de Operações Privilegiadas.

Você pode atualizar o DACL e o SACL na instância Win32_SecurityDescriptor ao chamar esse método, mas também pode atualizar apenas o DACL ou apenas o SACL.

Os valores a seguir no SECURITY_DESCRIPTOR_CONTROL determinar se o DACL ou o SACL ou ambos são atualizados.

• SE_DACL_PRESENT

  Indica que a DACL deve ser atualizada. Se isso não estiver definido, o WMI preservará o valor original da DACL.

• SE_SACL_PRESENT

  Indica que o SACL deve ser atualizado. Se isso não estiver definido, o WMI preservará o valor original do SACL. Para atualizar o SACL, a conta deve ter o privilégio SeSecurityPrivilege habilitado. Para scripts, o nome do privilégio é SeSecurityPrivilege. Para obter mais informações, consulte As Constantes de Privilégios.

Se o administrador do Grupo e as propriedades de administrador do Proprietário não forem NULL, eles serão atualizados. Caso contrário, o WMI preservará os valores originais. Para obter mais informações, consulte Objetos do Descritor de Segurança WMI.

Quando um novo SACL é NULL em uma chamada desse método, o SACL do descritor de segurança no objeto protegível de destino é deixado inalterado.

Requisitos

Consulte também

__SystemSecurity

Definindo descritores de segurança do namespace