Método ChangeSecurityPermissionsEx da classe Win32_ShortcutFile
O método de classe WMIChangeSecurityPermissionsEx altera as permissões de segurança para o arquivo de atalho 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 será recursivo e alterará as permissões de segurança de todos os arquivos e subdiretórios que o diretório contém.
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]
-
Expressão que é resolvida para uma instância do Win32_SecurityDescriptor. Esse parâmetro contém novas permissões de segurança para a instância do Win32_PageFile.
-
Opção [in]
-
Privilégio de segurança a ser modificado. Por exemplo, para alterar a segurança do proprietário e da DACL (lista de controle de acesso discricionário), use o seguinte:
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 DACL (lista de controle de acesso discricionário) do arquivo lógico.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Altere a SACL (lista de controle de acesso do sistema) do arquivo lógico.
StopFileName [out]
Nome do arquivo ou diretório em que o método ChangeSecurityPermissionsEx falhou. Esse parâmetro será NULL se o método for bem-sucedido.
StartFileName [in, opcional]
Nomeia o arquivo ou diretório filho a ser usado como ponto de partida para ChangeSecurityPermissionsEx. Normalmente, o parâmetro StartFileName é o parâmetro StopFileName que especifica o arquivo ou diretório em que ocorreu um erro da chamada de método anterior. Se esse parâmetro for NULL, a operação será executada no arquivo ou diretório especificado na chamada ExecMethod .
Recursivo [in, opcional]
Se for true, a alteração de propriedade será aplicada recursivamente a arquivos e diretórios dentro do diretório especificado pela instância CIM_LogicalFile .
Observação
Para instâncias de arquivo, o parâmetro Recursive é ignorado.
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 é o 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 |
|