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

Article
02/28/2024

La méthode GetAccessRights demande des informations sur les droits d’accès qui peuvent être contrôlés pour un objet sécurisable. L’éditeur de contrôle d’accès appelle cette méthode pour récupérer les chaînes d’affichage et d’autres informations utilisées pour initialiser les pages de propriétés. Pour plus d’informations, consultez Droits d’accès et masques d’accès.

Syntaxe

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

Paramètres

[in] pguidObjectType

Pointeur vers une structure GUID qui identifie le type d’objet pour lequel des droits d’accès sont demandés. Si ce paramètre a la valeur NULL ou un pointeur vers GUID_NULL, retournez les droits d’accès pour l’objet en cours de modification. Sinon, le GUID identifie un type d’objet enfant retourné par la méthode ISecurityInformation ::GetInheritTypes . Le GUID correspond au membre InheritedObjectType d’un ACE spécifique à un objet.

[in] dwFlags

Ensemble d’indicateurs de bits qui indiquent la page de propriétés en cours d’initialisation. Cette valeur est égale à zéro si la page de sécurité de base est en cours d’initialisation. Sinon, il s’agit d’une combinaison des valeurs suivantes.

Valeur	Signification
SI_ADVANCED	La feuille de propriétés Advanced Security est en cours d’initialisation.
SI_EDIT_AUDITS	La feuille de propriétés Advanced Security inclut la page des propriétés Audit .
SI_EDIT_PROPERTIES	La feuille de propriétés Advanced Security permet de modifier les AE qui s’appliquent aux propriétés et aux jeux de propriétés de l’objet.

[out] ppAccess

Pointeur vers un tableau de structures SI_ACCESS . Le tableau doit inclure une entrée pour chaque droit d’accès. Vous pouvez spécifier des droits d’accès qui s’appliquent à l’objet lui-même, ainsi que des droits d’accès spécifiques à l’objet qui s’appliquent uniquement à un jeu de propriétés ou à une propriété sur l’objet.

[out] pcAccesses

Pointeur vers ULONG qui indique le nombre d’entrées dans le tableau ppAccess .

[out] piDefaultAccess

Pointeur vers ULONG qui indique l’index de base zéro de l’entrée de tableau qui contient les droits d’accès par défaut. L’éditeur de contrôle d’accès utilise cette entrée comme droits d’accès initiaux dans un nouvel ACE.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

La méthode GetAccessRights est appelée chaque fois qu’une page de propriétés est initialisée.

L’éditeur de contrôle d’accès ne libère pas le pointeur retourné dans ppAccess.

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