Método ChangeSecurityPermissionsEx de la clase CIM_DataFile

El método ChangeSecurityPermissionsEx cambia los permisos de seguridad para el archivo de datos lógico especificado en la ruta de acceso del objeto (este método es una versión extendida del método ChangeSecurityPermissions ). Si el archivo lógico es realmente un directorio, este método actuará de forma recursiva, cambiando los permisos de seguridad 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 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

Parámetros

SecurityDescriptor [in]

Especifica información de seguridad.

Nota:

Una ACL NULL en la estructura de SECURITY_DESCRIPTOR concede acceso ilimitado. Para obtener más información sobre las implicaciones del acceso ilimitado, vea Crear un descriptor de seguridad para un nuevo objeto.

Opción [in]

Privilegio de seguridad que se va a modificar. Por ejemplo, para cambiar el propietario y la seguridad de DACL, use:

Option = 1 + 4 o 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 ACL del archivo lógico.

CHANGE_SACL_SECURITY_INFORMATION (8)

Cambie la ACL del sistema del archivo lógico.

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 realiza correctamente.

StartFileName [in, optional]

Cadena que representa el archivo secundario (o directorio) que se va a usar como punto de partida para este método. 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 .

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

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_DataFile . 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. Para obtener códigos de error adicionales, consulte Constantes de error de WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Success

0

Correcto.

Acceso denegado

2

Acceso denegado.

Error no especificado

8

Error no especificado.

Objeto no válido

9

El nombre de objeto especificado no es 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

El archivo de inicio no es válido.

Privilegios no mantenidos

17

Privilegios no mantenidos.

Parámetro no válido

21

Un parámetro no es válido.

Comentarios

WMI implementa el método ChangeSecurityPermissionsEx en CIM_DataFile .

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 del SDK de Microsoft 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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_DataFile

CIM_DataFile

Tareas de WMI: archivos y carpetas

Constantes de derechos de acceso a archivos y directorios