TRUSTEE_A-Struktur (accctrl.h)

Artikel
08/22/2023

Die TRUSTEE-Struktur identifiziert das Benutzerkonto, das Gruppenkonto oder die Anmeldesitzung , für die ein Zugriffssteuerungseintrag (Access Control Entry , ACE) gilt. Die -Struktur kann einen Namen oder eine Sicherheits-ID (SID) verwenden, um den Treuhänder zu identifizieren.

Zugriffssteuerungsfunktionen, z. B. SetEntriesInAcl und GetExplicitEntriesFromAcl, verwenden diese Struktur, um das Anmeldekonto zu identifizieren, das den Zugriffssteuerungs- oder Überwachungssteuerungsinformationen 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;

Member

pMultipleTrustee

Ein Zeiger auf eine TRUSTEE-Struktur , die ein Serverkonto identifiziert, das die Identität des vom ptstrName-Member identifizierten Benutzers annehmen kann. Dieser Member wird derzeit nicht unterstützt und muss NULL sein.

MultipleTrusteeOperation

Ein Wert des MULTIPLE_TRUSTEE_OPERATION Enumerationstyps. Derzeit muss dieser Member NO_MULTIPLE_TRUSTEE sein.

TrusteeForm

Ein Wert aus dem TRUSTEE_FORM Enumerationstyp, der den Datentyp angibt, auf den der ptstrName-Member verweist.

TrusteeType

Ein Wert aus dem TRUSTEE_TYPE Enumerationstyp, der angibt, ob der Treuhänder ein Benutzerkonto, ein Gruppenkonto oder ein unbekannter Kontotyp ist.

ptstrName

Ein Zeiger auf einen Puffer, der den Treuhänder identifiziert und optional Informationen zu objektspezifischen ACEs enthält. Der Typ der Daten hängt vom Wert des TrusteeForm-Elements ab.

Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
TRUSTEE_IS_NAME	Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Treuhänders enthält.
TRUSTEE_IS_OBJECTS_AND_NAME	Ein Zeiger auf eine OBJECTS_AND_NAME Struktur, die den Namen des Treuhänders und die Namen der Objekttypen in einem objektspezifischen ACE enthält.
TRUSTEE_IS_OBJECTS_AND_SID	Ein Zeiger auf eine OBJECTS_AND_SID Struktur, die die SID des Treuhänders und die GUIDs der Objekttypen in einem objektspezifischen ACE enthält.
TRUSTEE_IS_SID	Zeiger auf die SID des Treuhänders.

pSid

pObjectsAndSid

pObjectsAndName

Hinweise

Ein Treuhändername kann eines 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 Sondernamen.

Name	Bedeutung
ERSTELLERGRUPPE	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 OWNER	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 eine der universellen, bekannten SIDs sein. Weitere Informationen finden Sie unter Sicherheits-IDs.

Hinweis

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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	accctrl.h