Partager via


AtlGetSacl

Appelez cette fonction pour extraire des 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 AtlGetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
CSacl* pSacl,
bool bRequestNeededPrivileges= true
) throw(...);

Paramètres

  • hObject
    Handle vers l'objet duquel récupérer 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 .

  • pSacl
    Pointeur vers un objet de SACL qui contient des informations de sécurité récupérées.

  • 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

Si AtlGetSacl 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

AtlSetSacl

Classe de CSacl

Autres ressources

Fonctions globales de sécurité