Freigeben über


TRUSTEE_A Struktur (accctrl.h)

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;
  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. Weitere Informationen finden Sie weiter unten in den Anmerkungen .

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, dessen Formular vom Wert des TrusteeForm-Elements abhängt, wird in LPCH umgestalten.

TrusteeForm Bedeutung von ptstrName
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
Ein Zeiger auf die SID des Trustees.

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

Siehe auch

ACL-

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

MULTIPLE_TRUSTEE_OPERATION

OBJECTS_AND_NAME

OBJECTS_AND_SID

SID-

SetEntriesInAcl-

TRUSTEE_FORM

TRUSTEE_TYPE