Método ChangeSecurityPermissions da classe Win32_Directory
O método de classe WMI ChangeSecurityPermissions altera as permissões de segurança para o arquivo de entrada de diretório lógico especificado no caminho do objeto. Se o arquivo lógico for um diretório, ChangeSecurityPermissions será recursivo e alterará as permissões de segurança de todos os arquivos e subdiretórios que o diretório contém. A classe ChangeSecurityPermissions retornará um valor inteiro de 0 (zero) se as permissões forem alteradas e um número diferente para indicar um erro.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
Parâmetros
-
SecurityDescriptor [in]
-
Expressão que é resolvida para uma instância de Win32_SecurityDescriptor. Esse descritor contém novas permissões de segurança para a instância de Win32_PageFile.
-
Opção [in]
-
Privilégio de segurança a ser modificado. Por exemplo, para alterar o proprietário e a segurança da DACL (lista de controle de acesso discricionário), use:
Option = 1 + 4-ou-
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
CHANGE_OWNER_SECURITY_INFORMATION (1)
-
Altere o proprietário do arquivo lógico.
-
CHANGE_GROUP_SECURITY_INFORMATION (2)
-
Altere o grupo do arquivo lógico.
-
CHANGE_DACL_SECURITY_INFORMATION (4)
-
Altere a DACL discricionária do arquivo lógico.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Altere a SACL (lista de controle de acesso do sistema) do arquivo lógico.
Valor retornado
Retorna um valor de 0 (zero) se as permissões forem alteradas e um número diferente para indicar um erro.
-
Êxito
-
0
A solicitação foi bem-sucedida.
-
Acesso negado
-
2
Acesso negado.
-
Falha não especificada
-
8
Ocorreu uma falha não especificada.
-
Objeto inválido
-
9
O nome especificado não é válido.
-
O objeto já existe
-
10
O objeto especificado já existe.
-
Sistema de arquivos não NTFS
-
11
O sistema de arquivos não é um sistema de arquivos NTFS.
-
Plataforma não NT/Windows 2000
-
12
A plataforma não é o Windows.
-
A unidade não é a mesma
-
13
A unidade não é a mesma.
-
Diretório não vazio
-
14
O diretório não está vazio.
-
Violação de compartilhamento
-
15
Há uma violação de compartilhamento.
-
Arquivo inicial inválido
-
16
O arquivo inicial especificado não é válido.
-
Privilégio não mantido
-
17
Um privilégio necessário para a operação não é mantido.
-
Parâmetro inválido
-
21
Um parâmetro especificado não é válido.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|