struttura TRUSTEE_W (accctrl.h)
La struttura TRUSTEE identifica l'account utente, l'account di 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 SID ( Security Identifier ) 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 sul controllo di controllo in una struttura di 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;
Members
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
Un 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 |
---|---|
|
Puntatore a una stringa con terminazione Null contenente il nome del trustee. |
|
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. |
|
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. |
|
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 "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.
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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | accctrl.h |