Método TakeOwnerShipEx de la clase CIM_LogicalFile
El método TakeOwnerShipEx obtiene la propiedad del archivo 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 un directorio, este método actúa de forma recursiva y toma posesión de todos los archivos y subdirectorios que contiene el directorio.
Importante
Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.
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]
-
Cadena que representa el nombre del archivo (o directorio) donde se produjo un error en el método. Este parámetro es null si el método se ejecuta correctamente.
-
StartFileName [in, opcional]
-
Cadena que asigna un nombre al archivo secundario (o directorio) que se usará como punto de partida para el método . Normalmente, este parámetro es el parámetro StopFileName que especifica el archivo o directorio en el que se produjo un error de 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 .
-
Recursiva [in, opcional]
-
Si es TRUE, el método también se aplica de forma recursiva a archivos y directorios dentro del directorio especificado por la instancia de CIM_LogicalFile . En el caso de las instancias de archivo, este parámetro se omite.
Valor devuelto
Devuelve un valor de 0 (cero) si se ejecuta correctamente y cualquier otro número para indicar un error.
-
Success
-
0
Correcto.
-
Acceso denegado
-
2
Acceso denegado.
-
Error no especificado
-
8
Error no especificado.
-
Objeto no válido
-
9
Objeto no válido.
-
El objeto ya existe
-
10
El objeto ya existe.
-
Sistema de archivos no NTFS
-
11
Sistema de archivos no NTFS.
-
Plataforma no NT/Windows 2000
-
12
Plataforma no Windows.
-
La unidad no es la misma
-
13
La unidad no es la misma.
-
Directorio no vacío
-
14
El directorio no está vacío.
-
Infracción de uso compartido
-
15
Infracción de uso compartido.
-
Archivo de inicio no válido
-
16
Archivo de inicio no válido.
-
Privilegios no mantenidos
-
17
No se mantiene el privilegio.
-
Parámetro no válido
-
21
Parámetro no válido.
Comentarios
Actualmente, WMI no implementa este método. Para usar este método, debe implementarlo en su propio proveedor.
Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación de Microsoft SDK o proporcionar más información.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|