Partager via


AtlGetSecurityDescriptor

Appelez cette fonction pour récupérer le modèle de sécurité d'un objet donné.

Important

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

inline bool AtlGetSecurityDescriptor( 
LPCTSTR pszObjectName, 
SE_OBJECT_TYPE ObjectType, 
CSecurityDesc * pSecurityDescriptor, 
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION |  
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |  
SACL_SECURITY_INFORMATION, 
bool bRequestNeededPrivileges= true 
) throw(...);

Paramètres

  • pszObjectName
    Pointeur vers une chaîne terminée par le caractère NULL qui spécifie le nom de 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 de pszObjectName .

  • pSecurityDescriptor
    L'objet qui reçoit le modèle demande de sécurité.

  • requestedInfo
    Un ensemble de bits indicateurs de SECURITY_INFORMATION qui indiquent le type d'informations de sécurité pour récupérer. Ce paramètre peut être une combinaison de valeurs suivantes.

  • 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 AtlGetSecurityDescriptor 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

Autres ressources

Fonctions globales de sécurité