Fonction CreateSecurityPage (aclui.h)

Article
08/22/2023

La fonction CreateSecurityPage crée une page de propriétés de sécurité de base qui permet à l’utilisateur d’afficher et de modifier les droits d’accès autorisés ou refusés par les entrées de contrôle d’accès (ACA) dans la liste de contrôle d’accès discrétionnaire (DACL) d’un objet. Utilisez la fonction PropertySheet ou le message PSM_ADDPAGE pour ajouter cette page à une feuille de propriétés.

Syntaxe

HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
  [in] LPSECURITYINFO psi
);

Paramètres

[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 fonction retourne un handle à une page de propriétés de sécurité de base.

Si la fonction échoue, elle retourne NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

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 DE contrôle d’accès de l’objet, la liste de contrôle d’accès système (SACL) 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