struttura ACTRL_ACCESS_ENTRYW (accctrl.h)

Articolo
08/22/2023

Contiene informazioni di controllo di accesso per un trustee specificato. Questa struttura archivia le informazioni equivalenti alle informazioni di controllo di accesso archiviate in un ACE.

Sintassi

typedef struct _ACTRL_ACCESS_ENTRYW {
  TRUSTEE_W     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPWSTR        lpInheritProperty;
} ACTRL_ACCESS_ENTRYW, *PACTRL_ACCESS_ENTRYW;

Membri

Trustee

Struttura TRUSTEE che identifica l'utente, il gruppo o il programma (ad esempio un servizio) a cui si applica la voce di controllo di accesso.

fAccessFlags

Indica il modo in cui i diritti di accesso specificati dal di accesso e ProvSpecificAccess membri si applicano al trustee. Questo membro può essere uno dei valori seguenti. Se si usa questa struttura con l'implementazione COM di IAccessControl, questo membro deve essere ACTRL_ACCESS_ALLOWED o ACTRL_ACCESS_DENIED.

Valore	Significato
ACTRL_ACCESS_ALLOWED 0x00000001	I diritti sono consentiti.
ACTRL_ACCESS_DENIED 0x00000002	I diritti vengono negati.
ACTRL_AUDIT_SUCCESS 0x00000004	Il sistema genera messaggi di controllo per i tentativi non riusciti di utilizzare i diritti.
ACTRL_AUDIT_FAILURE 0x00000008	Il sistema genera messaggi di controllo per i tentativi riusciti di utilizzare i diritti.

Access

Maschera di bit che specifica i diritti di accesso consentiti, negati o controllati dal trustee.

Questo membro deve usare i flag di accesso indipendenti dal provider, ad esempio ACTRL_READ_CONTROL, anziché i flag di accesso, ad esempio READ_CONTROL. Il provider per il tipo di oggetto converte questi flag indipendenti dal provider nei flag specifici del provider corrispondenti.

Se si usa questa struttura con l'implementazione COM di IAccessControl, questo membro deve essere COM_RIGHTS_EXECUTE.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

Maschera di bit che specifica i diritti di accesso specifici del tipo di provider. Le funzioni che usano la struttura ACTRL_ACCESS_ENTRY passano questi bit al provider senza interpretarli. Nella maggior parte dei casi, questo membro deve essere 0.

Inheritance

Set di flag di bit che determina se altri contenitori o oggetti possono ereditare la voce di controllo di accesso dall'oggetto primario a cui è associato l'elenco di accesso. Se si usa questa struttura con l'implementazione COM di IAccessControl, questo valore deve essere NO_INHERITANCE, che indica che la voce di controllo di accesso non è ereditabile. In caso contrario, questo valore può essere NO_INHERITANCE oppure può essere una combinazione dei valori seguenti.

Valore	Significato
CONTAINER_INHERIT_ACE 0x2	Altri contenitori contenuti nell'oggetto primario ereditano la voce.
INHERIT_ONLY_ACE 0x8	L'ace non si applica all'oggetto primario a cui è associato l'ACL, ma gli oggetti contenuti nell'oggetto primario ereditano la voce.
NO_PROPAGATE_INHERIT_ACE 0x4	I flag OBJECT_INHERIT_ACE e CONTAINER_INHERIT_ACE non vengono propagati a una voce ereditata.
OBJECT_INHERIT_ACE 0x1	Gli oggetti non contenitore contenuti nell'oggetto primario ereditano la voce.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Entrambi i contenitori e gli oggetti non contenitore contenuti nell'oggetto primario ereditano la voce. Questo flag corrisponde alla combinazione dei flag CONTAINER_INHERIT_ACE e OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Altri contenitori contenuti nell'oggetto primario ereditano la voce. Questo flag corrisponde al flag CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT 0x1	Gli oggetti non contenitore contenuti nell'oggetto primario ereditano la voce. Questo flag corrisponde al flag OBJECT_INHERIT_ACE.

lpInheritProperty

Puntatore a una stringa con terminazione Null che identifica i tipi di oggetto che possono ereditare la voce. Se si usa questa struttura con l'implementazione COM di IAccessControl, questo membro deve essere NULL.

Osservazioni

Nota

L'intestazione accctrl.h definisce ACTRL_ACCESS_ENTRY come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	accctrl.h

Vedere anche

ACTRL_ACCESS_ENTRY_LIST

TRUSTEE

Condividi tramite