Compartilhar via


Método TakeOwnerShip da classe CIM_Directory

O método TakeOwnerShip obtém a propriedade do arquivo lógico especificado no caminho do objeto. 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. Esse método é herdado de CIM_LogicalFile.

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 TakeOwnerShip();

Parâmetros

Esse método não tem parâmetros.

Valor retornado

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

0

Êxito.

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

A plataforma não é 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.

Exemplos

O código script do Visual Basic a seguir chama o método TakeOwnerShip para assumir a propriedade da pasta C:\temp.

strComputer = "." 

Set objWMIService = _
    GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 

' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod( _
    "Win32_Directory.Name='C:\\temp'", "TakeOwnerShip")

wscript.echo objOutParams.ReturnValue

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