Funzione GetTraceLoggerHandle (evntrace.h)
Un provider di eventi basato su RegisterTraceGuids ("classico") usa la funzione GetTraceLoggerHandle per recuperare l'handle della sessione di traccia eventi a cui scrivere eventi.
I provider chiamano questa funzione dalla funzione ControlCallback .
Sintassi
TRACEHANDLE WMIAPI GetTraceLoggerHandle(
[in] PVOID Buffer
);
Parametri
[in] Buffer
Puntatore a una struttura WNODE_HEADER . ETW passa questa struttura alla funzione ControlCallback del provider nel parametro Buffer .
Il membro HistoricalContext di WNODE_HEADER contiene l'handle della sessione.
Valore restituito
Se la funzione ha esito positivo, restituisce l'handle sessione di traccia eventi.
Se la funzione ha esito negativo, restituisce INVALID_HANDLE_VALUE. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .
Commenti
Si usa l'handle quando si chiamano le funzioni GetTraceEnableFlags e GetTraceEnableLevel per recuperare i flag di abilitazione e i valori di livello passati alla funzione EnableTrace .
Esempio
Per un esempio che usa GetTraceLoggerHandle, vedere Recupero dei dati dell'evento tramite MOF.
Requisiti
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | evntrace.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |