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

Funciones básicas de Access Control

GetSecurityDescriptorControl

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl