Función SetSecurityDescriptorControl (securitybaseapi.h)

Artículo
08/25/2023

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