Método ChangeSecurityPermissions da classe CIM_Directory

O método 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, 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. Esse método é herdado de CIM_LogicalFile.

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]

Especifica informações de segurança.

Observação

Uma ACL (lista de controle de acesso) NULL na estrutura SECURITY_DESCRIPTOR concede acesso ilimitado.

Opção [in]

Privilégio de segurança 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 ACL do arquivo lógico.

CHANGE_SACL_SECURITY_INFORMATION (8)

Altere a ACL do sistema do arquivo lógico.

Valor retornado

Retorna um valor de 0 (zero) em caso de êxito e qualquer outro número para indicar um erro.

0

Sucesso.

2

Acesso negado.

8

Falha não especificada.

9

Objeto inválido.

10

O objeto já existe.

11

Sistema de arquivos não NTFS.

12

Plataforma não Windows.

13

A unidade não é a mesma.

14

O diretório não está vazio.

15

Violação de compartilhamento.

16

Arquivo inicial inválido.

17

Privilégio não mantido.

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.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

Requisitos

Confira também

CIM_Directory

CIM_Directory