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 |