Método ChangeSecurityPermissionsEx de la clase Win32_ShortcutFile
El método de clase WMIChangeSecurityPermissionsEx cambia los permisos de seguridad para el archivo de acceso directo lógico especificado en la ruta de acceso al objeto (este método es una versión extendida del método ChangeSecurityPermissions). Si el archivo lógico es un directorio, este método es recursivo y cambia los permisos de seguridad 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 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parámetros
-
SecurityDescriptor [in]
-
Expresión que se resuelve en una instancia de Win32_SecurityDescriptor. Este parámetro contiene nuevos permisos de seguridad para la instancia de Win32_PageFile.
-
Opción [in]
-
Privilegio de seguridad que se va a modificar. Por ejemplo, para cambiar la seguridad de la lista de control de acceso discrecional (DACL) del propietario y de la lista de control de acceso discrecional, use lo siguiente:
Option = 1 + 4or
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
CHANGE_OWNER_SECURITY_INFORMATION (1)
-
Cambie el propietario del archivo lógico.
-
CHANGE_GROUP_SECURITY_INFORMATION (2)
-
Cambie el grupo del archivo lógico.
-
CHANGE_DACL_SECURITY_INFORMATION (4)
-
Cambie la lista de control de acceso discrecional (DACL) del archivo lógico.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Cambie la lista de control de acceso del sistema (SACL) del archivo lógico.
StopFileName [out]
Nombre del archivo o directorio en el que se produjo un error en el método ChangeSecurityPermissionsEx . Este parámetro es NULL si el método se realiza correctamente.
StartFileName [in, opcional]
Asigna un nombre al archivo o directorio secundario que se va a usar como punto de partida para ChangeSecurityPermissionsEx. Normalmente, el parámetro StartFileName es 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 .
Recursiva [in, opcional]
Si es true, el cambio de propiedad se aplica de forma recursiva a los archivos y directorios del directorio especificado por la instancia de CIM_LogicalFile .
Nota
En el caso de las instancias de archivo, se omite el parámetro Recursive .
Valor devuelto
Devuelve un valor de 0 (cero) si se cambian los permisos y un número diferente para indicar un error.
-
Success
-
0
La solicitud se realiza correctamente.
-
Acceso denegado
-
2
Acceso denegado.
-
Error no especificado
-
8
Error no especificado.
-
Objeto no válido
-
9
El nombre especificado no es válido.
-
El objeto ya existe
-
10
El objeto especificado ya existe
-
Sistema de archivos no NTFS
-
11
El sistema de archivos no es ntfs.
-
Plataforma no NT/Windows 2000
-
12
La plataforma no es 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
Hay una infracción de uso compartido.
-
Archivo de inicio no válido
-
16
El archivo de inicio especificado no es válido.
-
Privilegios no mantenidos
-
17
No se mantiene un privilegio necesario para la operación.
-
Parámetro no válido
-
21
Un parámetro especificado no es válido.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|