BuildTrusteeWithObjectsAndNameA-Funktion (aclapi.h)

Artikel
02/23/2024

Die BuildTrusteeWithObjectsAndName-Funktion initialisiert eine TRUSTEE-Struktur mit den objektspezifischen Ace-Informationen (Access Control Entry ) und initialisiert die verbleibenden Elemente der Struktur mit Standardwerten. Der Aufrufer gibt auch den Namen des Treuhänders an.

Syntax

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

Parameter

[in, out] pTrustee

Ein Zeiger auf eine TRUSTEE-Struktur , die von dieser Funktion initialisiert wird. Wenn der Wert dieses Parameters NULL oder ein ungültiger Zeiger ist, sind die Ergebnisse nicht definiert.

[in, optional] pObjName

Ein Zeiger auf eine OBJECTS_AND_NAME Struktur, die Informationen zum Vertrauensempfänger und zum sicherungsfähigen Objekt enthält.

[in, optional] ObjectType

Ein Zeiger auf eine SE_OBJECT_TYPE-Enumeration , die Informationen zum Typ des sicherungsfähigen Objekts enthält.

[in, optional] ObjectTypeName

Ein Zeiger auf eine Zeichenfolge, der den Namen angibt, der der ObjectType-GUID entspricht, die der TRUSTEE-Struktur hinzugefügt werden soll, die im pTrustee-Parameter zurückgegeben wird. Diese Funktion bestimmt die ObjectType-GUID, die diesem Namen entspricht.

[in, optional] InheritedObjectTypeName

Ein Zeiger auf eine Zeichenfolge, der den Namen angibt, der der InheritedObjectType-GUID entspricht, die der TRUSTEE-Struktur hinzugefügt werden soll, die im pTrustee-Parameter zurückgegeben wird. Diese Funktion bestimmt die InheritedObjectType-GUID, die diesem Namen entspricht.

[in, optional] Name

Ein Zeiger auf eine Zeichenfolge, die den Namen angibt, der zum Identifizieren des Treuhänders verwendet wird.

Rückgabewert

Keine

Bemerkungen

Diese Funktion weist keinen Arbeitsspeicher für die TRUSTEE- und OBJECTS_AND_NAME-Strukturen zu.

Weitere Informationen zu objektspezifischen ACEs finden Sie unter Objektspezifische ACEs.

Hinweis

Der aclapi.h-Header definiert BuildTrusteeWithObjectsAndName 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]
Zielplattform	Windows
Kopfzeile	aclapi.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll