ACTRL_ACCESS_ENTRYA struttura (accctrl.h)

Articolo
02/28/2024

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

Sintassi

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

Members

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 come si applicano i diritti di accesso specificati dai membri Access e ProvSpecificAccess 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 tentativi non riusciti di usare i diritti.
ACTRL_AUDIT_FAILURE 0x00000008	Il sistema genera messaggi di controllo per tentativi riusciti di usare i diritti.

Access

Maschera bit che specifica i diritti di accesso che la voce consente, nega o controlla per il 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 è collegato 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 o 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 è collegato l'ACL, ma gli oggetti contenuti dall'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 Noncontainer contenuti dall'oggetto primario ereditano la voce.
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	Sia contenitori che oggetti noncontainer contenuti dall'oggetto primario ereditano la voce. Questo flag corrisponde alla combinazione dei flag di CONTAINER_INHERIT_ACE e di OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT 0x2	Altri contenitori contenuti nell'oggetto primario ereditano la voce. Questo flag corrisponde al flag di CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT 0x1	Gli oggetti Noncontainer contenuti dall'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.

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	accctrl.h

Vedi anche

ACTRL_ACCESS_ENTRY_LIST

FIDUCIARIO

Condividi tramite