TRUSTEE_A struttura (accctrl.h)

Articolo
03/11/2023

La struttura TRUSTEE identifica l'account utente, l'account del gruppo o la sessione di accesso a cui si applica una voce di controllo di accesso (ACE). La struttura può usare un nome o un identificatore di sicurezza (SID) per identificare il trustee.

Le funzioni di controllo di accesso, ad esempio SetEntriesInAcl e GetExplicitEntriesFromAcl, usano questa struttura per identificare l'account di accesso associato al controllo di accesso o alle informazioni di controllo di controllo in una struttura di EXPLICIT_ACCESS .

Sintassi

typedef struct _TRUSTEE_A {
  struct _TRUSTEE_A          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  union {
    LPSTR              ptstrName;
    SID                *pSid;
    OBJECTS_AND_SID    *pObjectsAndSid;
    OBJECTS_AND_NAME_A *pObjectsAndName;
  };
  LPCH                       ptstrName;
} TRUSTEE_A, *PTRUSTEE_A, TRUSTEEA, *PTRUSTEEA;

Members

pMultipleTrustee

Puntatore a una struttura TRUSTEEE che identifica un account server che può rappresentare l'utente identificato dal membro ptstrName . Questo membro non è attualmente supportato e deve essere NULL.

MultipleTrusteeOperation

Valore del tipo di enumerazione MULTIPLE_TRUSTEE_OPERATION . Attualmente, questo membro deve essere NO_MULTIPLE_TRUSTEE.

TrusteeForm

Valore del tipo di enumerazione TRUSTEE_FORM che indica il tipo di dati a cui punta il membro ptstrName .

TrusteeType

Valore del tipo di enumerazione TRUSTEE_TYPE che indica se il trustee è un account utente, un account di gruppo o un tipo di account sconosciuto.

ptstrName

Puntatore a un buffer che identifica il trustee e, facoltativamente, contiene informazioni sugli ACL specifici dell'oggetto. Il tipo di dati dipende dal valore del membro TrusteeForm .

Questo membro può essere uno dei valori seguenti.

Valore	Significato
TRUSTEE_IS_NAME	Puntatore a una stringa con terminazione null contenente il nome dell'utente attendibile.
TRUSTEE_IS_OBJECTS_AND_NAME	Puntatore a una struttura OBJECTS_AND_NAME contenente il nome del trustee e i nomi dei tipi di oggetto in un ACE specifico dell'oggetto.
TRUSTEE_IS_OBJECTS_AND_SID	Puntatore a una struttura OBJECTS_AND_SID che contiene il SID dell'attendibilità e i GUID dei tipi di oggetto in un ACE specifico dell'oggetto.
TRUSTEE_IS_SID	Puntatore al SID del trustee.

pSid

pObjectsAndSid

pObjectsAndName

Commenti

Un nome trustee può avere uno dei formati seguenti:

Nome completo, ad esempio "g:\remotedir\abc".
Un account di dominio, ad esempio "domain1\xyz".
Uno dei nomi di gruppo predefiniti, ad esempio "TUTTI" o "GUEST".

Uno dei nomi speciali seguenti.

Nome	Significato
CREATOR GROUP	L'CREATOR_GROUP SID è un SID usato negli ACL ereditabili. Quando viene creato un nuovo oggetto, il sistema sostituisce questo SID con il SID primario dell'utente che ha creato l'oggetto.
CREATOR OWNER	La CREATOR_OWNER SID è un SID usato negli ACL ereditabili. Quando viene creato un nuovo oggetto, il sistema sostituisce questo SID con il SID dell'utente che ha creato l'oggetto.
CURRENT_USER	Proprietario del thread o del processo chiamante.

Un SID trustee può essere qualsiasi SID utente o gruppo. Può anche essere uno dei SID universali, ben noti. Per altre informazioni, vedere Identificatori di sicurezza.

Nota

L'intestazione accctrl.h definisce TRUSTEE_ 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.