Méthode ISecurityInformation ::GetSecurity (aclui.h)
La méthode GetSecurity demande un descripteur de sécurité pour l’objet sécurisable dont le descripteur de sécurité est en cours de modification. L’éditeur de contrôle d’accès appelle cette méthode pour récupérer le descripteur de sécurité actuel ou par défaut de l’objet.
Syntaxe
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
Paramètres
[in] RequestedInformation
Ensemble d’indicateurs de bits SECURITY_INFORMATION qui indiquent les parties du descripteur de sécurité demandées. Ce paramètre peut être une combinaison des valeurs suivantes.
[out] ppSecurityDescriptor
Pointeur vers une variable que votre implémentation doit définir sur un pointeur vers le descripteur de sécurité de l’objet. Le descripteur de sécurité doit inclure les composants demandés par le paramètre RequestedInformation .
Le système appelle la fonction LocalFree pour libérer le pointeur retourné.
[in] fDefault
Si ce paramètre a la valeur TRUE, ppSecurityDescriptor doit retourner un descripteur de sécurité par défaut défini par l’application pour l’objet. L’éditeur de contrôle d’accès utilise ce descripteur de sécurité par défaut pour réinitialiser la page de propriétés.
L’éditeur de contrôle d’accès définit ce paramètre sur TRUE uniquement si l’utilisateur clique sur le bouton Par défaut . Le bouton Default s’affiche uniquement si vous définissez l’indicateur SI_RESET dans la méthode ISecurityInformation ::GetObjectInformation . Si aucun descripteur de sécurité par défaut n’est disponible, ne définissez pas l’indicateur SI_RESET.
Si cet indicateur a la valeur FALSE, ppSecurityDescriptor doit retourner le descripteur de sécurité actuel de l’objet.
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. Retourne E_ACCESSDENIED si l’utilisateur n’a pas l’autorisation de lire les informations de sécurité demandées.
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
fonctions de l’éditeur de Access Control