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

Vedi anche

EVENT_INFO_CLASS

EventRegister