Funzione GetTraceEnableFlags (evntrace.h)

Un provider di eventi basato su RegisterTraceGuids ("classico") usa la funzione GetTraceEnableFlags per recuperare i flag di abilitazione specificati dal controller di traccia per indicare la categoria di eventi da tracciare.

I provider chiamano questa funzione dalla funzione ControlCallback .

Sintassi

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACELOGGER_HANDLE TraceHandle
);

Parametri

[in] TraceHandle

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

Valore restituito

Restituisce il valore del controller specificato nel parametro EnableFlag 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 GetTraceEnableFlags per recuperare i flag enable.
3. Se il valore enable flags è 0, chiamare la funzione GetLastError per recuperare l'ultimo errore noto.
4. Se l'ultimo errore noto è ERROR_SUCCESS, il controller imposta i flag di abilitazione su 0; in caso contrario, la funzione GetTraceEnableFlags non è riuscita con l'ultimo errore noto.

Commenti

I provider possono usare questo valore per controllare gli eventi generati. Ad esempio, un provider può raggruppare gli eventi in categorie logiche di eventi e usare questo valore per abilitare o disabilitare la generazione.

Esempio

Per un esempio che usa GetTraceEnableFlags, vedere Recupero dei dati degli eventi tramite MOF.

Requisiti

Vedi anche

GetTraceEnableLevel

GetTraceLoggerHandle