Funzione SetTraceCallback (evntrace.h)

Importante

Non usare questa funzione; potrebbe non essere disponibile nelle versioni successive. Filtrare invece la classe di traccia eventi nella funzione EventRecordCallback .

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	evntrace.h
Libreria	Sechost.lib in Windows 8.1 e Windows Server 2012 R2; Advapi32.lib in Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP
DLL	Sechost.dll in Windows 8.1 e Windows Server 2012 R2; Advapi32.dll in Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP

Vedi anche

EventCallback

ProcessTrace

RemoveTraceCallback