Método ChangeSecurityPermissionsEx de la clase Win32_CodecFile

El método de clase WMIChangeSecurityPermissionsEx cambia los permisos de seguridad para el archivo de códec 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 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 descriptor contiene nuevos permisos de seguridad para la instancia de Win32_CodecFile.

Opción [in]

Privilegios de seguridad reales que se van 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 + 4

O bien

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1 (0x1))

Cambie el propietario del archivo lógico.

CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2))

Cambie el grupo del archivo lógico.

CHANGE_DACL_SECURITY_INFORMATION (4 (0x4))

Cambie la lista de control de acceso discrecional (DACL) del archivo lógico.

CHANGE_SACL_SECURITY_INFORMATION (8 (0x8))

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 cuando 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 ChangeSecurityPermissionsEx. Normalmente, el parámetro StartFileName es el parámetro StopFileName que especifica el archivo o directorio donde 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, los cambios de propiedad se aplican recursivamente a los archivos y directorios del directorio que especifica la instancia de CIM_LogicalFile . En el caso de las instancias de archivo, se omite el parámetro de entrada recursivo .

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 un sistema de archivos NTFS.

Plataforma no NT/Windows 2000

12

La plataforma no es Windows NT ni Windows 2000.

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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de sistema operativo

Win32_CodecFile