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 + 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 (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	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_ShortcutFile