EventSetInformation-Funktion (evntprov.h)

Konfiguriert einen ETW-Ereignisanbieter.

Syntax

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

Parameter

[in] RegHandle

Ereignisanbieterregistrierungshandle. Dies ist ein von EventRegister zurückgegebenes Handle.

[in] InformationClass

EVENT_INFO_CLASS Wert, der den Konfigurationsvorgang angibt, der für den Ereignisanbieter ausgeführt werden soll.

[in] EventInformation

Zeiger auf einen Puffer, der Daten enthält, die beim Konfigurieren des Ereignisanbieters verwendet werden sollen. Das Format der Daten in diesem Puffer hängt von dem im Parameter InformationClass angegebenen Wert ab.

Dieser Wert kann sein NULL , wenn InformationLength 0 ist.

[in] InformationLength

Die Größe (in Bytes) der Daten im EventInformation-Puffer .

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

• ERROR_INVALID_PARAMETER: Der Parameter ist falsch. Dieser Fehler wird beispielsweise zurückgegeben, wenn der RegHandle-Parameter kein gültiges Anbieterregistrierungshandle ist, wenn EventInformationNULL , Aber InformationLength nichtzero ist oder wenn der angegebene InformationLength für die angegebene InformationClass ungültig ist.
• ERROR_NOT_SUPPORTED: Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der InformationClass-Parameter kein erkannter Wert ist.
• Sonstiges: Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	evntprov.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

EVENT_INFO_CLASS

EventRegister