Funzione TraceQueryInformation (evntrace.h)

La funzione TraceQueryInformation fornisce informazioni su una sessione di traccia eventi.

Sintassi

ULONG WMIAPI TraceQueryInformation(
                  CONTROLTRACE_ID  TraceId,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Parametri

TraceId

[in] InformationClass

Classe di informazioni da eseguire query. Le informazioni acquisite dalla classe sono incluse nella sezione dati estesi dell'evento. Per un elenco di classi di informazioni che è possibile eseguire query, vedere l'enumerazione TRACE_QUERY_INFO_CLASS .

[out] TraceInformation

Puntatore a un buffer per ricevere i dati specifici della classe di informazioni restituita. La classe di informazioni determina il contenuto di questo parametro. Ad esempio, per la classe di informazioni TraceStackTracingInfo , questo parametro è una matrice di strutture CLASSIC_EVENT_ID . Le strutture specificano i GUID evento per cui è abilitata la traccia dello stack. La matrice è limitata a 256 elementi.

[in] InformationLength

Dimensioni, in byte, dei dati restituiti nel buffer TraceInformation . Se la funzione ha esito negativo, questo valore indica le dimensioni necessarie del buffer TraceInformation necessario.

[out, optional] ReturnLength

Puntatore a un valore che riceve le dimensioni, in byte, dei dati specifici restituiti nel buffer TraceInformation .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

• ERROR_BAD_LENGTH

  Il programma ha rilasciato un comando ma la lunghezza del comando non è corretta. Questo errore viene restituito se il parametro InformationLength è minore di una dimensione minima.

• ERROR_INVALID_PARAMETER

  Parametro non corretto.

• ERROR_NOT_SUPPORTED

  La richiesta non è supportata.

• Altri

  Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione TraceQueryInformation esegue query sulle impostazioni della sessione di traccia degli eventi da una sessione di traccia. Chiamare questa funzione dopo aver chiamato StartTrace.

Requisiti

Vedi anche

TRACE_QUERY_INFO_CLASS

TraceSetInformation