BuildTrusteeWithNameA-Funktion (aclapi.h)

Artikel
08/22/2023

Die BuildTrusteeWithName-Funktion initialisiert eine TRUSTEE-Struktur . Der Aufrufer gibt den Namen des Treuhänders 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 zu initialisierende TRUSTEE-Struktur . Die BuildTrusteeWithName-Funktion weist keinen Arbeitsspeicher zu. Wenn dieser Parameter NULL oder ein ungültiger Zeiger ist, sind die Ergebnisse nicht definiert.

[in, optional] pName

Ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Treuhänders für das ptstrName-Element 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

Keine

Bemerkungen

Hinweis

Der aclapi.h-Header 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 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