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
| 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 in Windows 8.1 e Windows Server 2012 R2; Advapi32.dll in Windows 8 e Windows Server 2012 |