Condividi tramite

Metodo IAccessControl::GrantAccessRights (iaccess.h)

  • Articolo

Unisce il nuovo elenco di diritti di accesso con i diritti di accesso esistenti per l'oggetto .

Sintassi

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

Parametri

[in] pAccessList

Puntatore alla struttura ACTRL_ACCESS che contiene una matrice di elenchi di accesso per l'oggetto .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'unione del nuovo elenco dei diritti di accesso con i diritti di accesso esistenti garantisce che l'oggetto disponga almeno dei diritti di accesso indicati. Questo processo di unione consiste nell'aggiungere i nuovi diritti di accesso negato prima dei diritti di accesso negato precedenti e i nuovi diritti di accesso consentiti prima dei diritti consentiti esistenti. Nessuno dei diritti esistenti viene rimosso.

In seguito a un'unione, i diritti di accesso per un oggetto vengono ordinati nel modo seguente:

  1. [Nuovo accesso negato]
  2. [Accesso negato precedente]
  3. [Nuovo accesso consentito]
  4. [Accesso precedente consentito]
Implementazione fornita dal sistema di [ACTRL_ACCESS](.. La struttura /accctrl/ns-accctrl-explicit_access_a.md) deve essere impostata su 1. Inoltre, il membro lpProperty della struttura ACTRL_PROPERTY_ENTRYW deve essere NULL per indicare che l'elenco di voci di accesso si applica all'oggetto stesso.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione iaccess.h

Vedi anche

IAccessControl