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 |