BuildTrusteeWithSidA-Funktion (aclapi.h)

Die BuildTrusteeWithSid-Funktion initialisiert eine TRUSTEE-Struktur . Der Aufrufer gibt den Sicherheitsbezeichner (SID) des Treuhänders an. Die Funktion legt andere Elemente der Struktur auf Standardwerte fest und sucht nicht nach dem namen, der der SID zugeordnet ist.

Syntax

void BuildTrusteeWithSidA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] PSID       pSid
);

Parameter

[in, out] pTrustee

Ein Zeiger auf eine zu initialisierende TRUSTEE-Struktur . Die BuildTrusteeWithSid-Funktion weist keinen Arbeitsspeicher zu. Wenn dieser Parameter NULL oder ein ungültiger Zeiger ist, sind die Ergebnisse nicht definiert.

[in, optional] pSid

Ein Zeiger auf eine SID-Struktur , die den Treuhänder identifiziert. Die BuildTrusteeWithSid-Funktion weist diesen Zeiger dem ptstrName-Member der TRUSTEE-Struktur zu. Die Funktion legt die anderen Elemente der TRUSTEE-Struktur wie folgt fest.

Wert Bedeutung
pMultipleTrustee
NULL
MultipleTrusteeOperation
NO_MULTIPLE_TRUSTEE
TrusteeForm
TRUSTEE_IS_SID
Trusteetype
TRUSTEE_IS_UNKNOWN

Rückgabewert

Keine

Bemerkungen

Hinweis

Der aclapi.h-Header definiert BuildTrusteWithSid als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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]
Zielplattform Windows
Kopfzeile aclapi.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

BuildTrusteeWithName

BuildTrusteeWithObjectsAndName

BuildTrusteeWithObjectsAndSid

TREUHÄNDER