Funzione SetTraceCallback (evntrace.h)

La funzione SetTraceCallback specifica una funzione EventCallback per elaborare gli eventi per la classe di traccia eventi specificata.

Sintassi

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

Parametri

[in] pGuid

Puntatore al GUID della classe di una classe di traccia di eventi per cui si desidera ricevere gli eventi. Per un elenco dei GUID della classe del provider del kernel, vedere Costanti del logger kernel NT.

[in] EventCallback

Puntatore a una funzione EventCallback usata per elaborare gli eventi appartenenti alla classe di traccia dell'evento.

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 di sistema. Di seguito sono riportati alcuni errori comuni e le relative cause.

• ERROR_INVALID_PARAMETER

  Una delle seguenti condizioni è vera:

  • pGuid è NULL.
  • EventCallback è NULL.

Commenti

I consumer chiamano questa funzione.

È possibile specificare una sola funzione di callback per una classe di traccia eventi. Se si specificano più di una funzione di callback per la classe di traccia eventi, l'ultima funzione di callback riceve gli eventi per tale classe di traccia eventi.

Per impedire alla funzione di callback di ricevere eventi per la classe di traccia evento, chiamare la funzione RemoveTraceCallback . Il callback interrompe automaticamente la ricezione dei callback quando si chiude la traccia.

È possibile usare questa funzione per ricevere eventi scritti usando una delle funzioni TraceEvent . Non è possibile utilizzare questa funzione per utilizzare gli eventi di un provider che ha usato una delle funzioni EventWrite per registrare gli eventi.

Requisiti

Vedi anche

EventCallback

ProcessTrace

RemoveTraceCallback