Funzione EventSetInformation (evntprov.h)
Configura un provider di eventi ETW.
Sintassi
ULONG EVNTAPI EventSetInformation(
[in] REGHANDLE RegHandle,
[in] EVENT_INFO_CLASS InformationClass,
[in] PVOID EventInformation,
[in] ULONG InformationLength
);
Parametri
[in] RegHandle
Handle di registrazione del provider di eventi. Si tratta di un handle restituito da EventRegister.
[in] InformationClass
EVENT_INFO_CLASS valore che specifica l'operazione di configurazione da eseguire nel provider di eventi.
[in] EventInformation
Puntatore a un buffer che contiene dati da utilizzare durante la configurazione del provider di eventi. Il formato dei dati in questo buffer dipende dal valore specificato nel parametro InformationClass .
Questo valore può essere NULL
se InformationLength è zero.
[in] InformationLength
Dimensioni (in byte) dei dati nel buffer EventInformation .
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
- ERROR_INVALID_PARAMETER: il parametro non è corretto. Ad esempio, questo errore viene restituito se il parametro RegHandle non è un handle di registrazione del provider valido, se EventInformation è NULL , ma InformationLength è diverso da zero o se l'elemento InformationLength specificato non è valido per la classe InformationClass specificata.
- ERROR_NOT_SUPPORTED: la richiesta non è supportata. Questo errore viene restituito se il parametro InformationClass non è un valore riconosciuto.
- Altro: usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.
Requisiti
Client minimo supportato | Windows 8 [app desktop | App UWP] |
Server minimo supportato | Windows Server 2012 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | evntprov.h |
Libreria | Advapi32.lib |
DLL | Advapi32.dll |