Partager via

Méthode IEffectivePermission ::GetEffectivePermission (aclui.h)

  • Article

La méthode GetEffectivePermission retourne l’autorisation effective pour un type d’objet.

Syntaxe

HRESULT GetEffectivePermission(
  [in]  const GUID           *pguidObjectType,
  [in]  PSID                 pUserSid,
  [in]  LPCWSTR              pszServerName,
  [in]  PSECURITY_DESCRIPTOR pSD,
  [out] POBJECT_TYPE_LIST    *ppObjectTypeList,
  [out] ULONG                *pcObjectTypeListLength,
  [out] PACCESS_MASK         *ppGrantedAccessList,
  [out] ULONG                *pcGrantedAccessListLength
);

Paramètres

[in] pguidObjectType

GUID pour le type d’objet dont l’autorisation est interrogée.

[in] pUserSid

Pointeur vers une structure SID qui représente le principal de sécurité dont l’autorisation effective est déterminée.

[in] pszServerName

Pointeur vers une chaîne de caractères larges terminée par null qui représente le nom du serveur.

[in] pSD

Pointeur vers une structure SECURITY_DESCRIPTOR qui représente le descripteur de sécurité de l’objet. Le descripteur de sécurité est utilisé pour effectuer l’case activée d’accès.

[out] ppObjectTypeList

Pointeur vers un pointeur vers une structure de OBJECT_TYPE_LIST qui représente le tableau de types d’objets dans l’arborescence d’objets de l’objet. Si un objet ne prend pas en charge l’accès à la propriété, utilisez la technique suivante pour spécifier la valeur de l’OBJECT_TYPE_LIST.

#include <windows.h>

OBJECT_TYPE_LIST g_DefaultOTL[] = {
 {0, 0, (LPGUID)&GUID_NULL},
};

[out] pcObjectTypeListLength

Pointeur vers un ULONG qui reçoit le nombre de types d’objets pointés par ppObjectTypeList.

[out] ppGrantedAccessList

Pointeur vers un pointeur vers un ACCESS_MASK qui reçoit le tableau des masques d’accès accordés. Le système d’exploitation utilise LocalFree pour libérer la mémoire allouée pour ce paramètre.

[out] pcGrantedAccessListLength

Pointeur vers une variable ULONG qui reçoit le nombre de masques d’accès accordés pointés vers le paramètre ppGrantedAccessList .

Valeur retournée

Si la fonction réussit, la valeur de retour est S_OK.

Si la fonction échoue, la valeur de retour est un HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

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