Fonction EditSecurity (aclui.h)

Article
02/23/2024

La fonction EditSecurity affiche une feuille de propriétés qui contient une page de propriétés de sécurité de base. Cette page de propriétés permet à l’utilisateur d’afficher et de modifier les droits d’accès autorisés ou refusés par les AIC dans la liste DACL d’un objet.

Syntaxe

BOOL ACLUIAPI EditSecurity(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi
);

Paramètres

[in] hwndOwner

Handle de la fenêtre qui possède la feuille de propriétés. Ce paramètre peut être NULL.

[in] psi

Pointeur vers votre implémentation de l’interface ISecurityInformation . Le système appelle les méthodes d’interface pour récupérer des informations sur l’objet en cours de modification et pour retourner l’entrée de l’utilisateur.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction EditSecurity appelle la fonction CreateSecurityPage pour créer une page de propriétés de sécurité de base.

Pendant l’initialisation de la page de propriétés, le système appelle les méthodes ISecurityInformation ::GetSecurity et ISecurityInformation ::SetSecurity pour déterminer si l’utilisateur est autorisé à modifier le descripteur de sécurité de l’objet. Le système affiche un message d’erreur si l’utilisateur n’a pas d’autorisation.

La page de propriétés de sécurité de base peut inclure un bouton Avancé pour afficher la feuille de propriétés de sécurité avancée. Cette feuille de propriétés de sécurité avancée peut contenir trois pages de propriétés supplémentaires qui permettent à l’utilisateur d’afficher et de modifier la liste DACL, la LISTE de contrôle d’accès partagé et le propriétaire de l’objet.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	aclui.h
Bibliothèque	Aclui.lib
DLL	Aclui.dll