Método GetEffectivePermission da classe CIM_DataFile

O método GetEffectivePermission determina se o chamador tem as permissões agregadas no objeto CIM_DataFile e o compartilhamento no qual o arquivo ou diretório reside, conforme especificado pelo argumento Permission . 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

boolean GetEffectivePermission(
  [in] uint32 Permissions
);

Parâmetros

Permissões [in]

Lista de permissões sobre as quais o chamador pode consultar.

FILE_READ_DATA (arquivo)FILE_LIST_DIRECTORY (diretório) (1 (0x1))

Concede o direito de ler dados do arquivo. Para um diretório, esse valor concede o direito de listar o conteúdo do diretório.

FILE_WRITE_DATA (arquivo)FILE_ADD_FILE (diretório) (2 (0x2))

Concede o direito de gravar dados no arquivo. Para um diretório, esse valor concede o direito de criar um arquivo no diretório.

FILE_APPEND_DATA (arquivo)FILE_ADD_SUBDIRECTORY (diretório) (4 (0x4))

Concede o direito de acrescentar dados ao arquivo. Para um diretório, esse valor concede o direito de criar um subdiretório.

FILE_READ_EA (8 (0x8))

Concede o direito de ler atributos estendidos.

FILE_WRITE_EA (16 (0x10))

Concede o direito de gravar atributos estendidos.

FILE_EXECUTE (arquivo)FILE_TRAVERSE (diretório) (32 (0x20))

Concede o direito de executar um arquivo. Para um diretório, o diretório pode ser percorrido.

FILE_DELETE_CHILD (diretório) (64 (0x40))

Concede o direito de excluir um diretório e todos os arquivos que ele contém, mesmo que os arquivos sejam somente leitura.

FILE_READ_ATTRIBUTES (128 (0x80))

Concede o direito de ler atributos de arquivo.

FILE_WRITE_ATTRIBUTES (256 (0x100))

Concede o direito de alterar atributos de arquivo.

DELETE (65536 (0x10000))

Concede acesso de exclusão.

READ_CONTROL (131072 (0x20000))

Concede acesso de leitura ao descritor de segurança e ao proprietário.

WRITE_DAC (262144 (0x40000))

Concede acesso de gravação à ACL discricionária.

WRITE_OWNER (524288 (0x80000))

Atribui o proprietário de gravação.

SYNCHRONIZE (1048576 (0x100000))

Sincroniza o acesso e permite que um processo aguarde a entrada de um objeto no estado sinalizado.

Valor retornado

Retorna True se a chamada tiver a permissão necessária; caso contrário, retornará false.

Comentários

O método GetEffectivePermission 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
Cabeçalho	Aclui.h
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