BuildTrusteeeWithNameA-Funktion (aclapi.h)

Artikel
11/20/2024

Die BuildTrusteeWithName-Funktion initialisiert eine TRUSTEE--Struktur. Der Aufrufer gibt den Vertrauensstellungsnamen an. Die Funktion legt andere Elemente der Struktur auf Standardwerte fest.

Syntax

void BuildTrusteeWithNameA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] LPSTR      pName
);

Parameter

[in, out] pTrustee

Ein Zeiger auf eine TRUSTEE- Struktur, die initialisiert werden soll. Die BuildTrusteeWithName-Funktion weist keinen Arbeitsspeicher zu. Wenn dieser Parameter NULL- oder einen ungültigen Zeiger ist, werden die Ergebnisse nicht definiert.

[in, optional] pName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Trustee für den ptstrName- Member der TRUSTEE--Struktur enthält. Die BuildTrusteeWithName--Funktion legt die anderen Member der TRUSTEE--Struktur wie folgt fest.

Wert	Bedeutung
pMultipleTrustee-	NULL
MultipleTrusteeOperation-	NO_MULTIPLE_TRUSTEE
TrusteeForm-	TRUSTEE_IS_NAME
TrusteeType-	TRUSTEE_IS_UNKNOWN

Rückgabewert

Nichts

Bemerkungen

Anmerkung

Der Header "aclapi.h" definiert BuildTrusteeWithName 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]
Zielplattform-	Fenster
Header-	aclapi.h
Library	Advapi32.lib
DLL-	Advapi32.dll