BuildTrusteeWithObjectsAndNameA-Funktion (aclapi.h)
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 |