Método TakeOwnerShipEx da classe do _ diretório Win32

O método de classe WMI TakeOwnerShipEx 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, na verdade, um diretório, esse método agirá recursivamente, assumindo a propriedade de todos os arquivos e subdiretórios contidos no diretório.

Este tópico usa a sintaxe formato MOF (MOF). 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 [ fora]

Nome do arquivo ou diretório em que o método TakeOwnerShipEx falhou. Esse parâmetro será nulo se o método tiver sucesso.

StartFileName [ em, opcional]

Nomeia o arquivo ou diretório filho 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 do método anterior. Se esse parâmetro for nulo, a operação será executada no arquivo ou diretório especificado na chamada de ExecMethod .

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

Recursivo [ em, opcional]

Se for true, a alteração de propriedade será aplicada recursivamente aos arquivos e diretórios dentro do diretório especificado pela instância de _ LogicalFile do CIM .

Observação

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

Retornar valor

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

0

A solicitação foi bem-sucedida.

2

Acesso 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 é 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 de inicialização especificado não era válido.

17

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

Abril

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

Exemplos

O código de script Visual Basic a seguir chama o método TakeOwnerShipEx para apropriar-se 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
Raiz \ cimv2
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Confira também

Classes do sistema operacional

_Diretório Win32