Méthode IAccessControl ::GetAllAccessRights (iaccess.h)

Article
02/29/2024

Obtient la liste complète des droits d’accès et/ou du propriétaire et du groupe pour l’objet spécifié.

Syntaxe

HRESULT GetAllAccessRights(
  [in]  LPWSTR                            lpProperty,
  [out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
  [out] PTRUSTEEW                         *ppOwner,
  [out] PTRUSTEEW                         *ppGroup
);

Paramètres

[in] lpProperty

Nom de la propriété. Si vous utilisez l’implémentation COM d’IAccessControl, ce paramètre doit être NULL.

[out] ppAccessList

Adresse de la variable pointeur qui reçoit un pointeur vers la structure de la liste d’accès. Ce paramètre ne peut pas être ACTRL_ACCESS.

Si l’appel réussit, l’appelant doit libérer la mémoire allouée avec la fonction CoTaskMemFree . Notez que la mémoire est allocation(all_nodes), ce qui signifie que toutes les sous-structures sont allouées dans un seul bloc. Par conséquent, l’ensemble de la structure de données doit être libéré par un seul appel à CoTaskMemFree.

[out] ppOwner

Pointeur vers une structure TRUSTEE qui reçoit les informations de propriétaire. Si ce paramètre n’est pas NULL et que la fonction réussit, l’appelant doit libérer la mémoire avec CoTaskMemFree.

[out] ppGroup

Pointeur vers une structure TRUSTEE qui reçoit les informations de groupe. Si ce paramètre n’est pas NULL et que la fonction réussit, l’appelant doit libérer la mémoire avec CoTaskMemFree.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iaccess.h

Voir aussi

ACTRL_ACCESS

IAccessControl

Partager via