Método TakeOwnerShipEx da classe Win32_Directory
O método de classe WMITakeOwnerShipEx 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, tomando 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 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 na 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, 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) em caso de ê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 é 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 do 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 |
|
| DLL |
|