Método TakeOwnerShipEx da classe CIM_LogicalFile

O método TakeOwnerShipEx obtém a propriedade do arquivo lógico especificado no caminho do objeto. Esse método é uma versão estendida do método TakeOwnerShip . Se o arquivo lógico for um diretório, esse método atuará recursivamente, assumindo a propriedade de todos os arquivos e subdiretórios que o diretório contém.

Importante

As classes CIM (Modelo de Informações Comuns) do DMTF (Distributed Management Task Force) 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 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Parâmetros

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 nomeia o arquivo filho (ou diretório) a ser usado como um ponto de partida para o método . Normalmente, esse parâmetro é o parâmetro StopFileName que especifica o arquivo ou diretório no qual ocorreu um erro da chamada de método anterior. Se esse parâmetro for nulo, a operação será executada no arquivo (ou diretório) especificado na chamada ExecMethod .

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

Êxito

0

Sucesso.

Acesso negado

2

Acesso negado.

Falha não especificada

8

Falha não especificada.

Objeto inválido

9

Objeto invá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

Arquivo inicial inválido.

Privilégio não mantido

17

Privilégio não mantido.

Parâmetro inválido

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_LogicalFile

CIM_LogicalFile