Método GetSecurityDescriptor da classe Win32_Service (Provedores WMI CIMWin32)
O método GetSecurityDescriptor retorna o descritor de segurança que controla o acesso ao serviço. O descritor é retornado como uma instância de Win32_SecurityDescriptor.
Sintaxe
uint32 GetSecurityDescriptor(
[out] Win32_SecurityDescriptor Descriptor
);
Parâmetros
-
Descritor [out]
-
O descritor de segurança associado ao serviço.
Retornar valor
Retorna um dos valores relacionados na seguinte lista ou um valor diferente para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro do WMI ou WbemErrorEnum. Para obter valores HRESULT gerais, consulte Códigos de erro do sistema.
-
Êxito
-
0
A solicitação foi aceita.
-
1
A solicitação não terá suporte.
-
Acesso negado
-
2
O usuário não tinha o acesso necessário.
-
3
O serviço não pode ser interrompido, porque outros serviços em execução dependem dele.
-
4
O código de controle pedido não é válido ou é inaceitável para o serviço.
-
5
O código de controle solicitado não pode ser enviado ao serviço porque o estado do serviço (propriedade Win32_BaseService.State) é igual a 0, 1 ou 2.
-
6
O serviço não foi iniciado.
-
7
O serviço não respondeu à solicitação de início em um tempo oportuno.
-
Falha desconhecida
-
8
Falha desconhecida ao iniciar o serviço.
-
Privilégio ausente
-
9
O caminho do diretório para o arquivo executável do serviço não foi encontrado.
-
10
O serviço já está em execução.
-
11
O banco de dados para adicionar um serviço novo está bloqueado.
-
12
Uma dependência da qual esse sistema depende foi removida do sistema.
-
13
O serviço não localizou o serviço necessário em um serviço dependente.
-
14
O serviço foi desabilitado do sistema.
-
15
O serviço não tem a autenticação correta para ser executado no sistema.
-
16
Este serviço está sendo removido do sistema.
-
17
O serviço não tem thread de execução.
-
18
O serviço tem dependências circulares quando é iniciado.
-
19
Há um serviço em execução com o mesmo nome.
-
20
O nome do serviço tem caracteres inválidos.
-
Parâmetro inválido
-
21
Parâmetros inválidos foram passados ao serviço.
-
22
A conta com a qual este serviço é executado é inválido ou não tem permissões para execute o serviço.
-
23
O serviço existe no banco de dados de serviços disponível no sistema.
-
24
O serviço está pausado atualmente no sistema.
-
Outras
-
22 4294967295
Comentários
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 Constantes de privilégio e Executar operações privilegiadas.
Exemplos
Ao recuperar um descritor de segurança no VBScript, certifique-se da “Segurança” e execute como administrador, conforme mostrado no snippet de código a seguir. Caso contrário, seu código pode gerar um erro de permissões.
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate, (Security)}!\\" & strComputer & "\root\cimv2")
Da mesma forma, em VB.NET, certifique-se de definir “EnablePrivileges = True” e execute o aplicativo como administrador.
Scope = New ManagementScope([String].Format("\\{0}\root\CIMV2", ComputerName), Nothing)
Scope.Options.EnablePrivileges = True
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|