Método TakeOwnerShipEx da classe CIM_Directory
O método 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 e é herdado de CIM_LogicalFile. 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 REF StopFileName,
[in] string StartFileName,
[in] 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]
-
Cadeia de caracteres que representa o arquivo filho (ou diretório) a ser usado como ponto de partida para esse 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]
-
Se True, o método será aplicado recursivamente a arquivos e diretórios dentro do diretório especificado pela instância CIM_Directory . Para instâncias de arquivo, esse parâmetro é ignorado.
Valor retornado
Retorna um valor de 0 em caso de êxito e qualquer outro número para indicar um erro.
-
0
Sucesso.
-
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 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 |
|