BuildTrusteeWithObjectsAndSidA-Funktion (aclapi.h)

Artikel
11/20/2024

Die BuildTrusteeWithObjectsAndSid-Funktion initialisiert eine TRUSTEE--Struktur mit den objektspezifischen Zugriffssteuerungseintragsinformationen (ACE) und initialisiert die verbleibenden Elemente der Struktur auf Standardwerte. Der Aufrufer gibt auch die SID- Struktur an, die den Sicherheitsbezeichner des Trustees darstellt.

Syntax

void BuildTrusteeWithObjectsAndSidA(
  [in, out]      PTRUSTEE_A       pTrustee,
  [in, optional] POBJECTS_AND_SID pObjSid,
  [in, optional] GUID             *pObjectGuid,
  [in, optional] GUID             *pInheritedObjectGuid,
  [in, optional] PSID             pSid
);

Parameter

[in, out] pTrustee

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

[in, optional] pObjSid

Ein Zeiger auf eine OBJECTS_AND_SID Struktur, die Informationen zum Trustee und zum sicherungsfähigen Objekt enthält.

[in, optional] pObjectGuid

Ein Zeiger auf eine GUID--Struktur, die die ObjectType-GUID beschreibt, die der TRUSTEE--Struktur hinzugefügt werden soll.

[in, optional] pInheritedObjectGuid

Ein Zeiger auf eine GUID--Struktur, die die InheritedObjectType-GUID beschreibt, die der TRUSTEE--Struktur hinzugefügt werden soll.

[in, optional] pSid

Ein Zeiger auf eine SID- Struktur, die den Trustee identifiziert.

Rückgabewert

Nichts

Bemerkungen

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

Weitere Informationen zu objektspezifischen ACEs finden Sie unter Objektspezifische ACEs.

Anmerkung

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