Compartilhar via


Método ChangeSecurityPermissionsEx da classe CIM_DataFile

O método ChangeSecurityPermissionsEx altera as permissões de segurança para o arquivo de dados lógico especificado no caminho do objeto (esse método é uma versão estendida do método ChangeSecurityPermissions ). Se o arquivo lógico for realmente 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.

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 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

Parâmetros

SecurityDescriptor [in]

Especifica informações de segurança.

Observação

Uma ACL NULL na estrutura SECURITY_DESCRIPTOR concede acesso ilimitado. Para obter mais informações sobre as implicações do acesso ilimitado, consulte Criando um descritor de segurança para um novo objeto.

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.

StopFileName [out]

Cadeia de caracteres que representa o nome do arquivo (ou diretório) em que o método falhou. Esse parâmetro será nulo se o método for bem-sucedido.

StartFileName [in, opcional]

Cadeia de caracteres que representa o arquivo filho (ou diretório) a ser usado como ponto de partida para esse método. Normalmente, o parâmetro StartFileName é o parâmetro StopFileName que especifica o arquivo ou diretório no qual ocorreu um erro na chamada do método anterior. Se esse parâmetro for nulo, a operação será executada no arquivo (ou diretório) especificado na chamada ExecMethod .

Se StartFileName for usado, Recursive também deverá ser definido como true.

Recursivo [in, opcional]

Se True, o método também será aplicado recursivamente a arquivos e diretórios dentro do diretório especificado pela instância de CIM_DataFile . Para instâncias de arquivo, esse parâmetro é ignorado.

Valor retornado

Retorna um valor de 0 (zero) em caso de êxito e qualquer outro número para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Êxito

0

Sucesso.

Acesso negado

2

Acesso negado.

Falha não especificada

8

Falha não especificada.

Objeto inválido

9

O nome do objeto especificado não é válido.

O objeto já existe

10

O objeto já existe.

Sistema de arquivos não NTFS

11

Sistema de arquivos não NTFS.

Plataforma não NT/Windows 2000

12

Plataforma nã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

Violação de compartilhamento.

Arquivo inicial inválido

16

O arquivo inicial não é válido.

Privilégio não mantido

17

Privilégio não mantido.

Parâmetro inválido

21

Um parâmetro não é válido.

Comentários

O método ChangeSecurityPermissionsEx no CIM_DataFile é implementado pelo WMI.

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_DataFile

CIM_DataFile

Tarefas do WMI: arquivos e pastas

Constantes de direitos de acesso de arquivo e diretório