Méthode ISecurityInformation ::SetSecurity (aclui.h)

La méthode SetSecurity fournit un descripteur de sécurité contenant les informations de sécurité que l’utilisateur souhaite appliquer à l’objet sécurisable. L’éditeur de contrôle d’accès appelle cette méthode lorsque l’utilisateur clique sur Ok ou Sur Appliquer.

Syntaxe

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Paramètres

[in] SecurityInformation

Ensemble d’indicateurs de bits SECURITY_INFORMATION qui indiquent les parties du descripteur de sécurité à définir. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur Signification
OWNER_SECURITY_INFORMATION
Le descripteur de sécurité contient le SID du propriétaire de l’objet.
GROUP_SECURITY_INFORMATION
Le descripteur de sécurité contient le SID du groupe principal de l’objet.
DACL_SECURITY_INFORMATION
Le descripteur de sécurité contient la liste DACL de l’objet.
SACL_SECURITY_INFORMATION
Le descripteur de sécurité contient la SACL de l’objet.

[in] pSecurityDescriptor

Pointeur vers un descripteur de sécurité contenant les nouvelles informations de sécurité. Ne supposez pas que le descripteur de sécurité est sous forme auto-relative ; il peut être absolu ou auto-relatif.

Valeur retournée

Retourne S_OK en cas de réussite.

Retourne un code d’erreur différent de zéro si une erreur se produit.

Remarques

Pour créer un descripteur de sécurité complet pour l’objet, l’application doit fusionner les nouvelles parties du descripteur de sécurité, telles que définies par le paramètre SecurityInformation , dans le descripteur de sécurité existant 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

Voir aussi

Éditeur Access Control

fonctions de l’éditeur de Access Control

ISecurityInformation

SECURITY_INFORMATION