TRUSTEE_A Struktur (accctrl.h)

Artikel
11/20/2024

Die TRUSTEE- Struktur identifiziert das Benutzerkonto, das Gruppenkonto oder Anmeldesitzung, auf das ein Zugriffssteuerungseintrag (ACE) angewendet wird. Die Struktur kann einen Namen oder einen Sicherheitsbezeichner (SID) verwenden, um den Truste zu identifizieren.

Zugriffssteuerungsfunktionen wie SetEntriesInAcl und GetExplicitEntriesFromAclverwenden Sie diese Struktur, um das Anmeldekonto zu identifizieren, das der Zugriffssteuerung oder Überwachungssteuerelementinformationen in einer EXPLICIT_ACCESS Struktur zugeordnet ist.

Syntax

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;

Angehörige

pMultipleTrustee

Ein Zeiger auf eine TRUSTEE--Struktur, die ein Serverkonto identifiziert, das den vom ptstrName Member identifizierten Benutzer imitieren kann. Dieses Element wird derzeit nicht unterstützt und muss NULL-sein.

MultipleTrusteeOperation

Ein Wert des MULTIPLE_TRUSTEE_OPERATION Enumerationstyps. Derzeit muss dieses Mitglied NO_MULTIPLE_TRUSTEE werden.

TrusteeForm

Ein Wert aus dem TRUSTEE_FORM Enumerationstyp, der den Typ der Daten angibt, auf die vom ptstrName Member verwiesen wird.

TrusteeType

Ein Wert aus dem TRUSTEE_TYPE Enumerationstyp, der angibt, ob es sich bei dem Trustee um ein Benutzerkonto, ein Gruppenkonto oder einen unbekannten Kontotyp handelt.

ptstrName

Ein Zeiger auf einen Puffer, der den Trustee identifiziert und optional Informationen zu objektspezifischen ACEs enthält. Der Datentyp hängt vom Wert des TrusteeForm-Mitglieds ab.

Dieses Element kann einer der folgenden Werte sein:

Wert	Bedeutung
TRUSTEE_IS_NAME	Ein Zeiger auf eine null-terminated string that contains the name of the trustee.
TRUSTEE_IS_OBJECTS_AND_NAME	Ein Zeiger auf eine OBJECTS_AND_NAME Struktur, die den Namen des Trustees und die Namen der Objekttypen in einer objektspezifischen ACE enthält.
TRUSTEE_IS_OBJECTS_AND_SID	Ein Zeiger auf eine OBJECTS_AND_SID Struktur, die die SID des Trustees und die GUIDs der Objekttypen in einer objektspezifischen ACE enthält.
TRUSTEE_IS_SID	Zeigen Sie auf die SID des Trustee.

pSid

pObjectsAndSid

pObjectsAndName

Bemerkungen

Ein Trustee-Name kann ein beliebiges der folgenden Formate aufweisen:

Ein vollqualifizierter Name, z. B. "g:\remotedir\abc".
Ein Domänenkonto, z. B. "domain1\xyz".
Einer der vordefinierten Gruppennamen, z. B. "JEDER" oder "GAST".

Einer der folgenden speziellen Namen.

Name	Bedeutung
CREATOR-GRUPPE	Die CREATOR_GROUP SID ist eine SID, die in vererbbaren ACEs verwendet wird. Wenn ein neues Objekt erstellt wird, ersetzt das System diese SID durch die primäre Gruppen-SID des Benutzers, der das Objekt erstellt hat.
CREATOR-BESITZER	Die CREATOR_OWNER SID ist eine SID, die in vererbbaren ACEs verwendet wird. Wenn ein neues Objekt erstellt wird, ersetzt das System diese SID durch die SID des Benutzers, der das Objekt erstellt hat.
CURRENT_USER	Der Besitzer des aufrufenden Threads oder Prozesses.

Eine Trustee-SID kann eine beliebige Benutzer- oder Gruppen-SID sein. Es kann auch jeder der universellen, bekannten SIDssein. Weitere Informationen finden Sie unter Sicherheitsbezeichner.

Anmerkung

Der accctrl.h-Header definiert TRUSTEE_ als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	accctrl.h