BuildTrusteeWithSidA-Funktion (aclapi.h)

Artikel
02/23/2024

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