Metodo IEffectivePermission::GetEffectivePermission (aclui.h)

  • Articolo

Il metodo GetEffectivePermission restituisce l'autorizzazione effettiva per un tipo di oggetto.

Sintassi

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
);

Parametri

[in] pguidObjectType

GUID per il tipo di oggetto il cui autorizzazione viene eseguita una query.

[in] pUserSid

Puntatore a una struttura SID che rappresenta l'entità di sicurezza il cui autorizzazione effettiva viene determinata.

[in] pszServerName

Puntatore a stringa di caratteri wide con terminazione null che rappresenta il nome del server.

[in] pSD

Puntatore a una struttura SECURITY_DESCRIPTOR che rappresenta il descrittore di sicurezza dell'oggetto. Il descrittore di sicurezza viene usato per eseguire il controllo di accesso.

[out] ppObjectTypeList

Puntatore a un puntatore a una struttura OBJECT_TYPE_LIST che rappresenta la matrice di tipi di oggetto nell'albero degli oggetti per l'oggetto. Se un oggetto non supporta l'accesso alle proprietà, utilizzare la tecnica seguente per specificare il valore per la OBJECT_TYPE_LIST.

#include <windows.h>

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

[out] pcObjectTypeListLength

Puntatore a un oggetto ULONG che riceve il conteggio dei tipi di oggetto a cui fa riferimento ppObjectTypeList.

[out] ppGrantedAccessList

Puntatore a un puntatore a un ACCESS_MASK che riceve la matrice di maschere di accesso concesse. Il sistema operativo userà LocalFree per liberare la memoria allocata per questo parametro.

[out] pcGrantedAccessListLength

Puntatore a una variabile ULONG che riceve il conteggio delle maschere di accesso concesse a cui punta il parametro ppGrantedAccessList .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è S_OK.

Se la funzione ha esito negativo, il valore restituito è un VALORE HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione aclui.h