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

Vedi anche

GetTraceEnableFlags

GetTraceEnableLevel