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:
- Chiamare la funzione SetLastError per impostare l'ultimo errore su ERROR_SUCCESS.
- Chiamare la funzione GetTraceEnableLevel per recuperare il livello di abilitazione.
- Se il valore del livello di abilitazione è 0, chiamare la funzione GetLastError per recuperare l'ultimo errore noto.
- 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 |