BuildTrusteeWithObjectsAndSidA-Funktion (aclapi.h)
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 |
Weitere Informationen
Grundlegende Access Control-Funktionen