EventAccessQuery-Funktion (evntcons.h)

  • Artikel

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
ERROR_MORE_DATA
 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

Weitere Informationen

EventAccessControl

EventAccessRemove