BuildTrusteeWithObjectsAndNameA-Funktion (aclapi.h)

Artikel
11/20/2024

Die BuildTrusteeWithObjectsAndName-Funktion initialisiert eine TRUSTEE- Struktur mit den objektspezifischen Zugriffssteuerungseintragsinformationen (ACE) und initialisiert die verbleibenden Elemente der Struktur auf Standardwerte. Der Aufrufer gibt auch den Namen des Trustee 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 Trustee und zum sicherungsfähigen Objekt enthält.

[in, optional] ObjectType

Ein Zeiger auf eine SE_OBJECT_TYPE-Aufzählung, 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, mit dem der Trustee identifiziert wird.

Rückgabewert

Nichts

Bemerkungen

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

Weitere Informationen zu objektspezifischen ACEs finden Sie unter Objektspezifische ACEs.

Anmerkung

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