Método ChangeSecurityPermissionsEx da classe CIM_LogicalFile
O método ChangeSecurityPermissionsEx altera as permissões de segurança para o arquivo lógico especificado no caminho do objeto (esse método é uma versão estendida do método ChangeSecurityPermissions ). Se o arquivo lógico for um diretório, esse método agirá recursivamente, alterando as permissões de segurança para todos os arquivos e subdiretórios que o diretório contém.
Importante
As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão cim 2.x.
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 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parâmetros
-
SecurityDescriptor [in]
-
Especifica as informações de segurança.
-
Opção [in]
-
Privilégio de segurança a ser modificado. Por exemplo, para alterar a segurança do proprietário e da DACL, use
Option = 1 + 4ou
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 ACL do arquivo lógico.
-
Change_Sacl_Security_Information (8)
-
Altere a ACL do sistema do arquivo lógico.
StopFileName [out]
Cadeia de caracteres que representa o nome do arquivo (ou diretório) em que o método falhou. Esse parâmetro terá um valor nulo se o método for bem-sucedido.
StartFileName [in, opcional]
Cadeia de caracteres que representa o arquivo filho (ou diretório) a ser usado como ponto de partida para esse método. Normalmente, o parâmetro StartFileName é o parâmetro StopFileName que especifica o arquivo (ou diretório) no qual ocorreu um erro na chamada do método anterior. Se o valor do parâmetro for nulo, a operação será executada no arquivo ou diretório especificado na chamada ExecMethod .
Recursivo [in, opcional]
Se TRUE, as permissões de segurança serão aplicadas recursivamente a arquivos e diretórios dentro do diretório especificado pela instância CIM_LogicalFile . Para instâncias de arquivo, esse parâmetro é ignorado.
Valor retornado
Retorna um valor de 0 (zero) em caso de êxito e qualquer outro número para indicar um erro.
-
Êxito
-
0
Sucesso.
-
Acesso negado
-
2
Acesso negado.
-
Falha não especificada
-
8
Falha não especificada.
-
Objeto inválido
-
9
Objeto inválido.
-
O objeto já existe
-
10
O objeto já existe.
-
Sistema de arquivos não NTFS
-
11
Sistema de arquivos não NTFS.
-
Plataforma não NT/Windows 2000
-
12
Plataforma nã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
Violação de compartilhamento.
-
Arquivo inicial inválido
-
16
Arquivo inicial inválido.
-
Privilégio não mantido
-
17
Privilégio não mantido.
-
Parâmetro inválido
-
21
Parâmetro inválido.
Comentários
Atualmente, esse método não é implementado pelo WMI. Para usar esse método, você deve implementá-lo em seu próprio provedor.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|