Partager via


AtlSetSacl

Appelez cette fonction pour définir les informations de (SACL) de liste de contrôle d'accès système d'un objet spécifié.

Important

Cette fonction ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.

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

Paramètres

  • hObject
    Handle vers l'objet pour lequel définit les informations de sécurité.

  • ObjectType
    Spécifie une valeur de l'énumération de SE_OBJECT_TYPE qui indique le type d'objet identifié par le paramètre d' hObject .

  • rSacl
    SACL contenant les nouvelles informations de sécurité.

  • dwInheritanceFlowControl
    Le contrôle de flux d'héritage.Cette valeur peut être 0 (la valeur par défaut), PROTECTED_SACL_SECURITY_INFORMATION ou UNPROTECTED_SACL_SECURITY_INFORMATION.

  • bRequestNeededPrivileges
    Si la valeur true est affectée, la fonction tente d'activer le privilège de SE_SECURITY_NAME, et le restaure de l'achèvement.

Valeur de retour

Retourne la valeur true en cas de réussite, false en cas d'échec.

Notes

Dans les versions debug, une erreur d'assertion se produit si hObject est incorrect, ou si dwInheritanceFlowControl n'est pas l'une des trois valeurs autorisées.

Si AtlSetSacl doit être appelé plusieurs fois sur de nombreux objets, il est plus efficace d'activer le privilège de SE_SECURITY_NAME une fois avant d'appeler la fonction, avec bRequestNeededPrivileges la valeur false.

Configuration requise

Header: atlsecurity.h

Voir aussi

Référence

AtlGetSacl

Classe de CSacl

Autres ressources

Fonctions globales de sécurité