Funzione TraceSetInformation (evntrace.h)
La funzione TraceSetInformation configura le impostazioni della sessione di traccia eventi.
Sintassi
ULONG WMIAPI TraceSetInformation(
CONTROLTRACE_ID TraceId,
[in] TRACE_INFO_CLASS InformationClass,
[in] PVOID TraceInformation,
[in] ULONG InformationLength
);
Parametri
TraceId
[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
| Requisito | Valore |
|---|---|
| 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 |