EventAccessControl-Funktion (evntcons.h)

Fügt die Berechtigungen des angegebenen Anbieters oder der angegebenen Sitzung hinzu oder ändert diese.

Syntax

ULONG EVNTAPI EventAccessControl(
  [in] LPGUID  Guid,
  [in] ULONG   Operation,
  [in] PSID    Sid,
  [in] ULONG   Rights,
  [in] BOOLEAN AllowOrDeny
);

Parameter

[in] Guid

GUID, die den Anbieter oder die Sitzung eindeutig identifiziert, dessen Berechtigungen Sie hinzufügen oder ändern möchten.

[in] Operation

Art des auszuführenden Vorgangs, z. B. Hinzufügen einer DACL zur GUID der Sitzung oder der GUID des Anbieters. Mögliche Werte finden Sie in der ENUMERATION EVENTSECURITYOPERATION .

[in] Sid

Die Sicherheits-ID (SID) des Benutzers oder der Gruppe, der Sie Berechtigungen erteilen oder verweigern möchten.

[in] Rights

Sie können mindestens eine der folgenden Berechtigungen angeben:

[in] AllowOrDeny

Wenn TRUE, erteilen Sie dem Benutzer Berechtigungen für die Sitzung oder den Anbieter. Andernfalls verweigern Sie Berechtigungen. Dieser Wert wird ignoriert, wenn der Wert von Operation EventSecuritySetSACL oder EventSecurityAddSACL lautet.

Rückgabewert

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück.

Hinweise

Standardmäßig kann nur der Administrator des Computers, Benutzer in der Gruppe Leistungsprotokollbenutzer und Dienste, die als LocalSystem, LocalService, NetworkService ausgeführt werden, Ablaufverfolgungssitzungen steuern und Ereignisdaten bereitstellen und nutzen. Nur Benutzer mit Administratorrechten und Diensten, die als LocalSystem ausgeführt werden, können eine NT-Kernelprotokollierungssitzung starten und steuern.

Windows Server 2003: Nur Benutzer mit Administratorrechten können Ablaufverfolgungssitzungen steuern und Ereignisdaten nutzen. Jeder Benutzer kann Ereignisdaten bereitstellen.

Windows XP und Windows 2000: Jeder Benutzer kann Ablaufverfolgungssitzungen steuern und Ereignisdaten bereitstellen und nutzen.

Benutzer mit Administratorrechten können Ablaufverfolgungssitzungen steuern, wenn das Tool, das sie zum Steuern der Sitzung verwenden, über ein Eingabeaufforderungsfenster gestartet wird, das mit Als Administrator ausführen... geöffnet wird.

Um einem eingeschränkten Benutzer die Möglichkeit zu geben, Ablaufverfolgungssitzungen zu steuern, können Sie sie der Gruppe Leistungsprotokollbenutzer hinzufügen oder diese Funktion aufrufen, um ihm die Berechtigung zu erteilen. Beispielsweise können Sie Dem Benutzer A die Berechtigung zum Starten und Beenden einer Ablaufverfolgungssitzung erteilen und Dem Benutzer B die Berechtigung erteilen, nur die Sitzung abzufragen.

Informationen zum Einschränken, wer Ereignisse auf die Sitzung protokollieren kann, finden Sie unter TRACELOG_LOG_EVENT Berechtigung.

Die ACL in der Protokolldatei bestimmt, wer Ereignisdaten aus der Protokolldatei nutzen kann. Um Ereignisse aus einer Sitzung in Echtzeit zu nutzen, müssen Sie dem Benutzer TRACELOG_ACCESS_REALTIME Berechtigung erteilen, oder der Benutzer muss Mitglied der Gruppe Leistungsprotokollbenutzer sein.

Sie können auch die GUID des Anbieters angeben, um einzuschränken, wer den Anbieter registrieren kann und wer den Anbieter aktivieren kann.

Anforderungen

Weitere Informationen

EventAccessQuery

EventAccessRemove