BuildTrusteeWithObjectsAndSidA-Funktion (aclapi.h)

Artikel
02/28/2024

Die BuildTrusteeWithObjectsAndSid-Funktion initialisiert eine TRUSTEE-Struktur mit den objektspezifischen ACE-Informationen (Access Control Entry ) und initialisiert die verbleibenden Elemente der Struktur als Standardwerte. Der Aufrufer gibt auch die SID-Struktur an, die den Sicherheitsbezeichner des Treuhänders 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 zu initialisierende TRUSTEE-Struktur . Die BuildTrusteeWithObjectsAndSid-Funktion weist keinen Arbeitsspeicher zu. Wenn dieser Parameter NULL oder ein ungültiger Zeiger ist, sind die Ergebnisse nicht definiert.

[in, optional] pObjSid

Ein Zeiger auf eine OBJECTS_AND_SID Struktur, die Informationen zum Treuhänder 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 Treuhänder identifiziert.

Rückgabewert

Keine

Bemerkungen

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

Weitere Informationen zu objektspezifischen ACEs finden Sie unter Objektspezifische ACEs.

Hinweis

Der aclapi.h-Header definiert BuildTrusteWithObjectsAndSid als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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