Función SetSecurityDescriptorControl (securitybaseapi.h)
La función SetSecurityDescriptorControl establece los bits de control de un descriptor de seguridad. La función solo puede establecer los bits de control relacionados con la herencia automática de ASE. Para establecer los demás bits de control de un descriptor de seguridad, use las funciones, como SetSecurityDescriptorDacl, para modificar los componentes de un descriptor de seguridad.
Sintaxis
BOOL SetSecurityDescriptorControl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
[in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);
Parámetros
[in] pSecurityDescriptor
Puntero a una estructura de SECURITY_DESCRIPTOR cuya información de control y revisión se establecen.
[in] ControlBitsOfInterest
Máscara de SECURITY_DESCRIPTOR_CONTROL que indica los bits de control que se van a establecer.
[in] ControlBitsToSet
Máscara de SECURITY_DESCRIPTOR_CONTROL que indica los nuevos valores de los bits de control especificados por la máscara ControlBitsOfInterest .
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
La función SetSecurityDescriptorControl especifica el bit o bits de control que se van a modificar y si los bits están activados o desactivados.
Ejemplos
En el ejemplo siguiente se marca la DACL en el descriptor de seguridad como protegido.
SetSecurityDescriptorControl( &SecDesc,
SE_DACL_PROTECTED, SE_DACL_PROTECTED );
En el ejemplo siguiente se marca la DACL como no protegida.
SetSecurityDescriptorControl( &SecDesc,
SE_DACL_PROTECTED, 0 );
Requisitos
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | securitybaseapi.h (incluya Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |
Consulte también
Información general del control de acceso