Método ChangeSecurityPermissions da classe Win32_ShortcutFile

O método de classe WMIChangeSecurityPermissions altera as permissões de segurança para o arquivo de atalho 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. 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 real a ser modificado. Por exemplo, para alterar o proprietário e a segurança da DACL, 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 (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.

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

Confira também

Classes do sistema operacional

Win32_ShortcutFile