struttura TRUSTEE_W (accctrl.h)

Articolo
11/20/2024

La struttura TRUSTEE identifica l'account utente, l'account di gruppo o 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.

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

Sintassi

typedef struct _TRUSTEE_W {
  struct _TRUSTEE_W          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  union {
    LPWSTR             ptstrName;
    SID                *pSid;
    OBJECTS_AND_SID    *pObjectsAndSid;
    OBJECTS_AND_NAME_W *pObjectsAndName;
  };
  LPWCH                      ptstrName;
} TRUSTEE_W, *PTRUSTEE_W, TRUSTEEW, *PTRUSTEEW;

Membri

pMultipleTrustee

Puntatore a una struttura TRUSTEE 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 un nullstringa con terminazione contenente il nome del trustee.
TRUSTEE_IS_OBJECTS_AND_NAME	Puntatore a una struttura OBJECTS_AND_NAME che contiene 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 del trustee e i GUID dei tipi di oggetto in un ace specifico dell'oggetto.
TRUSTEE_IS_SID	Puntatore al SID del trustee.

pSid

pObjectsAndSid

pObjectsAndName

Osservazioni

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 "EVERYONE" o "GUEST".

Uno dei nomi speciali seguenti.

Nome	Significato
CREATOR GROUP	Il SID CREATOR_GROUP è un SID usato negli ACL ereditabili. Quando viene creato un nuovo oggetto, il sistema sostituisce questo SID con il SID del gruppo primario dell'utente che ha creato l'oggetto.
CREATOR OWNER	Il SID CREATOR_OWNER è 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 qualsiasi dei SID universali e 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 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.