Funzione TraceSetInformation (evntrace.h)

  • Articolo

La funzione TraceSetInformation configura le impostazioni della sessione di traccia eventi.

Sintassi

ULONG WMIAPI TraceSetInformation(
  [in] TRACEHANDLE      SessionHandle,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Parametri

[in] SessionHandle

Handle della sessione di traccia eventi da configurare. La funzione StartTrace restituisce questo handle all'avvio di una nuova traccia. Per ottenere l'handle di una traccia esistente, utilizzare ControlTrace per eseguire una 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 abilitare o disabilitare. Le informazioni acquisite dalla classe sono incluse nella sezione dei dati estesi dell'evento. Per un elenco delle classi di informazioni che è possibile abilitare, vedere l'enumerazione TRACE_QUERY_INFO_CLASS .

[in] TraceInformation

Puntatore a dati specifici della classe di informazioni. La classe di informazioni determina il contenuto di questo parametro.

[in] InformationLength

Dimensioni, in byte, dei dati nel buffer TraceInformation .

Valore restituito

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

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

  • ERROR_BAD_LENGTH

    Il programma ha emesso 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 del messaggio per l'errore restituito.

Commenti

Chiamare questa funzione dopo aver chiamato StartTrace.

Se il parametro InformationClass è impostato su TraceStackTracingInfo, la chiamata a questa funzione abilita la traccia dello stack degli eventi del kernel specificati. Le chiamate successive a questa funzione sovrascrivono l'elenco precedente di eventi del kernel per cui è abilitata la traccia dello stack. Per disabilitare la traccia dello stack, chiamare questa funzione con InformationClass impostato su TraceStackTracingInfo e InformationLength impostato su 0.

La sezione dei dati estesi dell'evento includerà lo stack di chiamate. La classe STACKWALK_EVENT MOF definisce il layout dei dati estesi.

In genere, nei computer a 64 bit non è possibile acquisire lo stack del kernel in determinati contesti quando gli errori di pagina non sono consentiti. Per abilitare l'esplorazione dello stack del kernel in x64, impostare il valore del DisablePagingExecutive Registro di sistema di gestione della memoria su 1. Il DisablePagingExecutive valore del Registro di sistema si trova nella seguente chiave del Registro di sistema: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Questa operazione deve essere eseguita solo a scopo di diagnosi temporanea perché aumenta l'utilizzo della memoria del sistema.

Requisiti

   
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [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, Windows Server 2012, Windows 7 e Windows Server 2008 R2
DLL Sechost.dll in Windows 8.1 e Windows Server 2012 R2; Advapi32.dll in Windows 8, Windows Server 2012, Windows 7 e Windows Server 2008 R2

Vedi anche

TRACE_QUERY_INFO_CLASS

TraceQueryInformation