Metodo ISecurityInformation::GetAccessRights (aclui.h)

Articolo
03/05/2024

Il metodo GetAccessRights richiede informazioni sui diritti di accesso che possono essere controllati per un oggetto a protezione diretta. L'editor di controllo di accesso chiama questo metodo per recuperare le stringhe di visualizzazione e altre informazioni usate per inizializzare le pagine delle proprietà. Per altre informazioni, vedere Diritti di accesso e maschere di accesso.

Sintassi

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

Parametri

[in] pguidObjectType

Puntatore a una struttura GUID che identifica il tipo di oggetto per cui vengono richiesti i diritti di accesso. Se questo parametro è NULL o un puntatore a GUID_NULL, restituire i diritti di accesso per l'oggetto da modificare. In caso contrario, il GUID identifica un tipo di oggetto figlio restituito dal metodo ISecurityInformation::GetInheritTypes . Il GUID corrisponde al membro InheritedObjectType di un ACE specifico dell'oggetto.

[in] dwFlags

Set di flag di bit che indicano l'inizializzazione della pagina delle proprietà. Questo valore è zero se la pagina di sicurezza di base viene inizializzata. In caso contrario, è una combinazione dei valori seguenti.

Valore	Significato
SI_ADVANCED	La finestra delle proprietà Advanced Security viene inizializzata.
SI_EDIT_AUDITS	Il foglio delle proprietà Advanced Security include la pagina delle proprietà Audit .
SI_EDIT_PROPERTIES	Il foglio delle proprietà Advanced Security consente di modificare gli ACL che si applicano alle proprietà e ai set di proprietà dell'oggetto.

[out] ppAccess

Puntatore a una matrice di strutture SI_ACCESS . La matrice deve includere una voce per ogni diritto di accesso. È possibile specificare i diritti di accesso che si applicano all'oggetto stesso, nonché diritti di accesso specifici dell'oggetto che si applicano solo a un set di proprietà o a una proprietà sull'oggetto.

[out] pcAccesses

Puntatore a ULONG che indica il numero di voci nella matrice ppAccess .

[out] piDefaultAccess

Puntatore a ULONG che indica l'indice in base zero della voce della matrice che contiene i diritti di accesso predefiniti. L'editor di controllo di accesso usa questa voce come diritti di accesso iniziale in un nuovo ACE.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

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

Commenti

Il metodo GetAccessRights viene chiamato ogni volta che viene inizializzata una pagina delle proprietà.

L'editor di controllo di accesso non libera il puntatore restituito in ppAccess.

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