Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
Siehe auch
grundlegende Zugriffssteuerungsfunktionen