Método TakeOwnerShipEx da classe Win32_Directory

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

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]

Nome do arquivo ou diretório em que o método TakeOwnerShipEx falhou. Esse parâmetro será NULL se o método for bem-sucedido.

StartFileName [in, opcional]

Nomeia o arquivo filho ou o diretório a ser usado como ponto de partida para TakeOwnerShipEx. O parâmetro StartFileName normalmente é 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 NULL, a operação será executada no arquivo ou diretório especificado na chamada ExecMethod .

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

Recursivo [in, opcional]

Se True, a alteração de propriedade será aplicada recursivamente a arquivos e diretórios dentro do diretório especificado pela instância CIM_LogicalFile .

Observação

Para instâncias de arquivo, o parâmetro de entrada recursivo é ignorado.

Valor retornado

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

0

A solicitação foi bem-sucedida.

2

O acesso foi negado.

8

Ocorreu uma falha não especificada.

9

O nome especificado não era válido.

10

O objeto especificado já existe.

11

O sistema de arquivos não é NTFS.

12

A plataforma não é Windows.

13

A unidade não é a mesma.

14

O diretório não está vazio.

15

Houve uma violação de compartilhamento.

16

O arquivo inicial especificado não era válido.

17

Um privilégio necessário para a operação não é mantido.

21

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

Exemplos

O código script Visual Basic a seguir chama o método TakeOwnerShipEx 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")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx").inParameters.SpawnInstance_()

' Add the input parameters.
objInParam.Properties_.Item("Recursive") =  true

' 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'", "TakeOwnerShipEx", objInParam)
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

Classes do sistema operacional

Win32_Directory