Condividi tramite


ACCESS_DENIED_ACE struttura (winnt.h)

La struttura ACCESS_DENIED_ACE definisce una voce di controllo di accesso (ACE) per l'elenco di controllo di accesso discrezionale (DACL) che controlla l'accesso a un oggetto. Un ACE negato all'accesso nega l'accesso a un oggetto per un trustee specifico identificato da un identificatore di sicurezza (SID).

Sintassi

typedef struct _ACCESS_DENIED_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       SidStart;
} ACCESS_DENIED_ACE;

Members

Header

Struttura ACE_HEADER che specifica le dimensioni e il tipo di ACE. Contiene anche flag che controllano l'ereditarietà dell'ACE dagli oggetti figlio. Il membro AceType della struttura ACE_HEADER deve essere impostato su ACCESS_DENIED_ACE_TYPE e il membro AceSize deve essere impostato sul numero totale di byte allocati per la struttura ACCESS_DENIED_ACE.

Mask

Struttura ACCESS_MASK che specifica i diritti di accesso negati in modo esplicito da questo ACE.

SidStart

Primo DWORD del SID di un trustee. I byte rimanenti del SID vengono archiviati in memoria contigua dopo il membro SidStart . Questo SID può essere aggiunto con i dati dell'applicazione.

Commenti

Le strutture ACE devono essere allineate ai limiti DWORD . Tutte le funzioni di gestione della memoria di Windows restituiscono handle allineati AWORD alla memoria.

I diritti di accesso specificati dal membro Mask vengono negati a qualsiasi trustee che possiede un SID abilitato che corrisponde al SID archiviato nel membro SidStart .

Una struttura ACCESS_DENIED_ACE può essere creata in un elenco di controllo di accesso (ACL) da una chiamata alla funzione AddAccessDeniedAce o AddAccessDeniedAceEx. Quando queste funzioni vengono usate, la quantità di memoria corretta necessaria per soddisfare il SID del trustee viene allocata e i valori dei membri Header.AceType e Header.AceSize vengono impostati automaticamente. Se viene usata la funzione AddAccessDeniedAceEx , viene impostato anche il membro Header.AceFlags . Quando una struttura ACCESS_DENIED_ACE viene creata all'esterno di un ACL, è necessario allocare memoria sufficiente per ospitare il SID completo del truste nel membro SidStart e la memoria contigua seguente e i valori dei membri Header.AceType, Header.AceFlags e Header.AceSize devono essere impostati in modo esplicito dall'applicazione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winnt.h (includere Windows.h)

Vedi anche

ACE

ACL

AddAccessDeniedAce

SID