Compartir a través de

AtlSetSacl

  • Artículo

Llame a esta función para establecer la información (SACL) de la lista de control de acceso del sistema de un objeto especificado.

Nota importanteImportante

Esta función no se puede utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.

 
inline bool AtlSetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
const CSacl& rSacl,
DWORD dwInheritanceFlowControl= 0,
bool bRequestNeededPrivileges= true
) throw(...);

Parámetros

  • hObject
    Identificador del objeto para que establezca la información de seguridad.

  • ObjectType
    Especifica un valor de enumeración de SE_OBJECT_TYPE que indica el tipo de objeto identificado por el parámetro de hObject .

  • rSacl
    Una SACL que contiene la nueva información de seguridad.

  • dwInheritanceFlowControl
    El control de flujo de herencia.Este valor puede ser 0 (valor predeterminado), PROTECTED_SACL_SECURITY_INFORMATION o UNPROTECTED_SACL_SECURITY_INFORMATION.

  • bRequestNeededPrivileges
    Si es true, la función intentará habilitar el privilegio de SE_SECURITY_NAME, y se restaura en la finalización.

Valor devuelto

Devuelve true si la operación se realiza correctamente; de lo contrario, devuelve false.

Comentarios

En las compilaciones de depuración, un error de aserción aparecerá si hObject no es válido, o si dwInheritanceFlowControl no es uno de los tres valores permitidos.

Si se va AtlSetSacl a llamar varias veces en varios objetos, será más eficaz habilitar el privilegio de SE_SECURITY_NAME una vez antes de llamar a la función, con bRequestNeededPrivileges establecido en false.

Requisitos

encabezado: atlsecurity.h

Vea también

Referencia

AtlGetSacl

Clase de CSacl

Otros recursos

Funciones globales de seguridad