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.

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 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

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

CIM_Directory

CIM_Directory