Método SetSecurityDescriptor de la clase __SystemSecurity

El método SetSecurityDescriptor escribe una versión actualizada del descriptor de seguridad que controla el acceso al espacio de nombres WMI al que está conectado. El descriptor de seguridad se representa mediante una instancia de __SecurityDescriptor. Para obtener más información, vea Cambio de seguridad de acceso en objetos protegibles.

Sintaxis

uint32 SetSecurityDescriptor(
  [in] __SecurityDescriptor Descriptor
);

Parámetros

Descriptor [in]

Descriptor de seguridad asociado al espacio de nombres WMI.

Valor devuelto

Devuelve uno de los valores enumerados en la lista siguiente o un valor diferente para indicar un error. Para obtener más información, vea Códigos de retorno WMI o WbemErrorEnum.

0

Finalización correcta.

2

El usuario no tiene acceso a la información solicitada.

8

Error desconocido.

9

El usuario no tiene privilegios adecuados para ejecutar el método .

21

Un parámetro especificado en la llamada al método no es válido.

Observaciones

La instancia de Win32_SecurityDescriptor representa un tipo de datos SECURITY_DESCRIPTOR_CONTROL y contiene una lista de control de acceso discrecional (DACL) y una lista de control de acceso del sistema (SACL). Para obtener más información, vea Listas de control de acceso.

Si no se concede o habilita SeSecurityPrivilege al obtener un descriptor de seguridad, solo se devuelve la DACL en el descriptor de seguridad devuelto. Para obtener más información, consulte Constantes de privilegios y Ejecución de operaciones con privilegios.

Puede actualizar la DACL y la SACL en la instancia de Win32_SecurityDescriptor al llamar a este método, pero también puede actualizar solo la DACL o solo la SACL.

Los siguientes valores de SECURITY_DESCRIPTOR_CONTROL determinan si se actualizan la DACL o la SACL o ambas.

• SE_DACL_PRESENT

  Indica que se debe actualizar la DACL. Si no se establece, WMI conserva el valor original de la DACL.

• SE_SACL_PRESENT

  Indica que se debe actualizar la SACL. Si no se establece, WMI conserva el valor original de la SACL. Para actualizar la SACL, la cuenta debe tener habilitado el privilegio SeSecurityPrivilege . Para el scripting, el nombre del privilegio es SeSecurityPrivilege. Para obtener más información, consulte Constantes de privilegios.

Si el administrador de confianza del grupo y las propiedades del administrador de propietarios no son NULL, se actualizan. De lo contrario, WMI conserva los valores originales. Para obtener más información, vea Objetos del descriptor de seguridad de WMI.

Cuando una nueva SACL es NULL en una llamada a este método, el descriptor de seguridad SACL del objeto protegible de destino se deja sin cambios.

Requisitos

Consulte también

__SystemSecurity

Establecer descriptores de seguridad de espacio de nombres