EventAccessQuery-Funktion (evntcons.h)
Ruft die Berechtigungen für den angegebenen Controller oder Anbieter ab.
Syntax
ULONG EVNTAPI EventAccessQuery(
[in] LPGUID Guid,
[in, out] PSECURITY_DESCRIPTOR Buffer,
[in, out] PULONG BufferSize
);
Parameter
[in] Guid
GUID, die den Anbieter oder die Sitzung eindeutig identifiziert.
[in, out] Buffer
Anwendungsseitig zugewiesener Puffer, der die Sicherheitsbeschreibung des Controllers oder Anbieters enthält.
[in, out] BufferSize
Größe des Sicherheitsdeskriptorpuffers in Bytes. Wenn die Funktion erfolgreich ist, empfängt dieser Parameter die Größe des verwendeten Puffers. Wenn der Puffer zu klein ist, gibt die Funktion ERROR_MORE_DATA zurück, und dieser Parameter empfängt die erforderliche Puffergröße. Wenn die Puffergröße bei der Eingabe null ist, werden keine Daten im Puffer zurückgegeben, und dieser Parameter empfängt die erforderliche Puffergröße.
Rückgabewert
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück.
Die Funktion gibt den folgenden Rückgabecode zurück, wenn ein Fehler auftritt:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Puffer ist zu klein, um die Sicherheitsbeschreibung zu empfangen. Neuzuordnung des Puffers mithilfe der in BufferSize zurückgegebenen Größe. |
Hinweise
Wenn die GUID nicht in der Registrierung vorhanden ist, gibt ETW die Standardberechtigungen für einen Anbieter oder Controller zurück. Ausführliche Informationen zum Angeben der GUID in der Registrierung finden Sie unter EventAccessControl.
Informationen zum Zugriff auf die Komponenten des Sicherheitsdeskriptors finden Sie unter Abrufen von Informationen aus einer ACL, den Funktionen GetSecurityDescriptorDacl, GetSecurityDescriptorSacl und GetAce sowie der ACE-Struktur .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | evntcons.h |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |