Funzione GetTraceEnableLevel (evntrace.h)

Un provider di eventi basato su RegisterTraceGuids ("classico") usa la funzione GetTraceEnableLevel per recuperare il livello di abilitazione specificato dal controller di traccia per indicare il livello di eventi da tracciare.

I provider chiamano questa funzione dalla funzione ControlCallback .

Sintassi

UCHAR WMIAPI GetTraceEnableLevel(
  [in] TRACEHANDLE TraceHandle
);

Parametri

[in] TraceHandle

Gestire una sessione di traccia eventi ottenuta chiamando la funzione GetTraceLoggerHandle .

Valore restituito

Restituisce il valore specificato nel parametro EnableLevel quando si chiama la funzione EnableTrace .

Per determinare se la funzione non è riuscita o il controller imposta i flag di abilitazione su 0, seguire questa procedura:

1. Chiamare la funzione SetLastError per impostare l'ultimo errore su ERROR_SUCCESS.
2. Chiamare la funzione GetTraceEnableLevel per recuperare il livello di abilitazione.
3. Se il valore del livello di abilitazione è 0, chiamare la funzione GetLastError per recuperare l'ultimo errore noto.
4. Se l'ultimo errore noto è ERROR_SUCCESS, il controller imposta il livello di abilitazione su 0; in caso contrario, la funzione GetTraceEnableLevel non è riuscita con l'ultimo errore noto.

Commenti

I provider usano questo valore per controllare la gravità degli eventi generati. Ad esempio, i provider possono usare questo valore per determinare se deve generare eventi informativi, avvisi o errori.

Esempio

Per un esempio che usa GetTraceEnableLevel, 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

Vedi anche

GetTraceEnableFlags

GetTraceLoggerHandle