Funzione TraceQueryInformation (evntrace.h)

  • Articolo

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

Sintassi

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

Parametri

[in] SessionHandle

Gestione della sessione di traccia eventi per la quale vengono raccolte informazioni. La funzione StartTrace restituisce questo handle quando viene avviata una nuova traccia. Per ottenere l'handle di una traccia esistente, usare ControlTrace per eseguire query sulle proprietà di traccia in base al nome della traccia e quindi ottenere l'handle dal campo Wnode.HistoricalContext dei dati restituiti EVENT_TRACE_PROPERTIES .

[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

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione evntrace.h
Libreria Sechost.lib in Windows 8.1 e Windows Server 2012 R2; Advapi32.lib in Windows 8 e Windows Server 2012
DLL Sechost.dll su Windows 8.1 e Windows Server 2012 R2; Advapi32.dll su Windows 8 e Windows Server 2012

Vedi anche

TRACE_QUERY_INFO_CLASS

TraceSetInformation