CveEventWrite-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Eine Ablaufverfolgungsfunktion für die Veröffentlichung von Ereignissen, wenn ein versuchter Sicherheitsrisiko-Exploit in Ihrer Anwendung im Benutzermodus erkannt wird.

Syntax

LONG CveEventWrite(
  [in]           PCWSTR CveId,
  [in, optional] PCWSTR AdditionalDetails
);

Parameter

[in] CveId

Ein Zeiger auf die CVE-ID, die der Sicherheitsanfälligkeit zugeordnet ist, für die dieses Ereignis ausgelöst wird.

[in, optional] AdditionalDetails

Ein Zeiger auf eine Zeichenfolge mit zusätzlichen Details, die der Ereignisproduzent dem Consumer dieses Ereignisses bereitstellen möchte.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn der Fehler erfolgreich war, oder einen der folgenden Werte.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens einer der Parameter ist ungültig.
ERROR_ARITHMETIC_OVERFLOW	Die Ereignisgröße ist größer als das zulässige Maximum (64.000 – Header).
ERROR_MORE_DATA	Die Sitzungspuffergröße ist für das Ereignis zu klein.
ERROR_NOT_ENOUGH_MEMORY	Tritt auf, wenn gefüllte Puffer versuchen, auf den Datenträger zu leeren, datenträger-IOs jedoch nicht schnell genug ausgeführt werden. Dies geschieht, wenn der Datenträger langsam ist und der Ereignisdatenverkehr hoch ist. Schließlich gibt es keine freien (leeren) Puffer mehr, und das Ereignis wird gelöscht.
STATUS_LOG_FILE_FULL	Die Echtzeitwiedergabedatei ist voll. Ereignisse werden erst in der Sitzung protokolliert, wenn ein Echtzeitconsumer die Ereignisse aus der Wiedergabedatei nutzt. Beenden Sie die Protokollierung von Ereignissen basierend auf diesem Fehlercode nicht.

Hinweise

Die CveEventWrite-Funktion veröffentlicht ein CVE-basiertes Ereignis. Diese Funktion sollte nur in Szenarien aufgerufen werden, in denen die Anwendung versucht, eine bekannte, gepatchte Sicherheitslücke auszunutzen. Im Idealfall sollte dieser Funktionsaufruf als Teil der Korrektur (Update) selbst hinzugefügt werden.

Der Standardconsumer für dieses Ereignis ist EventLog-Application. Um einen anderen Consumer zu aktivieren, kann der Anbieter der Consumersitzung hinzugefügt werden.

Anbieter-GUID: 85a62a0d-7e17-485f-9d4f-749a287193a6

Quellname: Microsoft-Windows-Audit-CVE oder Audit-CVE

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Freigeben über