Método TakeOwnerShipEx de la clase Win32_Directory

Artículo
06/12/2023

El método de clase WMITakeOwnerShipEx obtiene la propiedad del archivo de entrada de directorio lógico especificado en la ruta de acceso del objeto. Este método es una versión extendida del método TakeOwnerShip . Si el archivo lógico es realmente un directorio, este método actúa de forma recursiva, tomando posesión de todos los archivos y subdirectorios que contiene el directorio.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

uint32 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Parámetros

StopFileName [out]

Nombre del archivo o directorio en el que se produjo un error en el método TakeOwnerShipEx . Este parámetro es NULL si el método se realiza correctamente.

StartFileName [in, optional]

Asigna un nombre al archivo o directorio secundario que se va a usar como punto de partida para TakeOwnerShipEx. El parámetro StartFileName suele ser el parámetro StopFileName que especifica el archivo o directorio en el que se produjo un error desde la llamada al método anterior. Si este parámetro es NULL, la operación se realiza en el archivo o directorio especificado en la llamada ExecMethod .

Si se usa StartFileName , Recursive también debe establecerse en true.

Recursiva [in, opcional]

Si es True, el cambio de propiedad se aplica de forma recursiva a archivos y directorios dentro del directorio especificado por la instancia de CIM_LogicalFile .

Nota

En el caso de las instancias de archivo, se omite el parámetro de entrada recursivo .

Valor devuelto

Devuelve un valor entero de 0 (cero) si se ejecuta correctamente y cualquier otro número para indicar un error.

0: La solicitud fue correcta.
2: Se denegó el acceso.
8: Error no especificado.
9: El nombre especificado no era válido.
10: El objeto especificado ya existe.
11: El sistema de archivos no es NTFS.
12: La plataforma no es Windows.
13: La unidad no es la misma.
14: El directorio no está vacío.
15: Se ha producido una infracción de uso compartido.
16: El archivo de inicio especificado no era válido.
17: No se mantiene un privilegio necesario para la operación.
21: Un parámetro especificado no es válido.

Ejemplos

El siguiente código de script de Visual Basic llama al método TakeOwnerShipEx para tomar posesión de la carpeta 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	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de sistema operativo
Win32_Directory

Compartir a través de