Partager via


structure TRUSTEE_W (accctrl.h)

La structure TRUSTEE identifie le compte d’utilisateur, le compte de groupe ou la session d’ouverture de session à laquelle une entrée de contrôle d’accès (ACE) s’applique. La structure peut utiliser un nom ou un identificateur de sécurité (SID) pour identifier le fiduciaire.

Les fonctions de contrôle d’accès, telles que SetEntriesInAcl et GetExplicitEntriesFromAcl, utilisent cette structure pour identifier le compte d’ouverture de session associé au contrôle d’accès ou aux informations de contrôle d’audit dans une structure EXPLICIT_ACCESS .

Syntaxe

typedef struct _TRUSTEE_W {
  struct _TRUSTEE_W          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  LPWCH                      ptstrName;
} TRUSTEE_W, *PTRUSTEE_W, TRUSTEEW, *PTRUSTEEW;

Members

pMultipleTrustee

Pointeur vers une structure TRUSTEE qui identifie un compte de serveur qui peut emprunter l’identité de l’utilisateur identifié par le membre ptstrName . Ce membre n’est actuellement pas pris en charge et doit avoir la valeur NULL.

MultipleTrusteeOperation

Valeur du type d’énumération MULTIPLE_TRUSTEE_OPERATION . Actuellement, ce membre doit être NO_MULTIPLE_TRUSTEE.

TrusteeForm

Valeur du type d’énumération TRUSTEE_FORM qui indique le type de données pointées par le membre ptstrName . Voir les remarques ci-dessous.

TrusteeType

Valeur du type d’énumération TRUSTEE_TYPE qui indique si le fiduciaire est un compte d’utilisateur, un compte de groupe ou un type de compte inconnu.

ptstrName

Pointeur dont le formulaire dépend de la valeur du membre TrusteeForm , converti en LPWCH.

TrusteeForm Signification de ptstrName
TRUSTEE_IS_NAME
Pointeur vers une chaîne terminée par null qui contient le nom du fiduciaire.
TRUSTEE_IS_OBJECTS_AND_NAME
Pointeur vers une structure OBJECTS_AND_NAME qui contient le nom du fiduciaire et les noms des types d’objets dans un ACE spécifique à l’objet.
TRUSTEE_IS_OBJECTS_AND_SID
Pointeur vers une structure OBJECTS_AND_SID qui contient le SID du fiduciaire et les GUID des types d’objets dans un ACE spécifique à l’objet.
TRUSTEE_IS_SID
Pointeur vers le SID du fiduciaire.

pSid

pObjectsAndSid

pObjectsAndName

Remarques

Un nom de fiduciaire peut avoir l’un des formats suivants :

  • Nom complet, tel que « g :\remotedir\abc ».
  • Un compte de domaine, tel que « domain1\xyz ».
  • Un des noms de groupe prédéfinis, tels que « EVERYONE » ou « GUEST ».
  • Un des noms spéciaux suivants.
    Nom Meaning
    CREATOR GROUP Le SID CREATOR_GROUP est un SID utilisé dans les AE héritées. Lorsqu’un nouvel objet est créé, le système remplace ce SID par le SID du groupe principal de l’utilisateur qui a créé l’objet.
    Créateur propriétaire Le SID CREATOR_OWNER est un SID utilisé dans les AE héritées. Lorsqu’un nouvel objet est créé, le système remplace ce SID par le SID de l’utilisateur qui a créé l’objet.
    CURRENT_USER Propriétaire du thread ou du processus appelant.
     
Un SID de fiduciaire peut être n’importe quel SID d’utilisateur ou de groupe. Il peut également s’agir de l’un des SID universels et connus. Pour plus d’informations, consultez Identificateurs de sécurité.

Note

L’en-tête accctrl.h définit TRUSTEE_ en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Header accctrl.h

Voir aussi

de liste de contrôle d’accès

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

MULTIPLE_TRUSTEE_OPERATION

OBJECTS_AND_NAME

OBJECTS_AND_SID

SID

SetEntriesInAcl

TRUSTEE_FORM

TRUSTEE_TYPE