Función TraceSetInformation (evntrace.h)
La función TraceSetInformation configura las opciones de sesión de seguimiento de eventos.
Sintaxis
ULONG WMIAPI TraceSetInformation(
[in] TRACEHANDLE SessionHandle,
[in] TRACE_INFO_CLASS InformationClass,
[in] PVOID TraceInformation,
[in] ULONG InformationLength
);
Parámetros
[in] SessionHandle
Identificador de la sesión de seguimiento de eventos que se va a configurar. La función StartTrace devuelve este identificador cuando se inicia un nuevo seguimiento. Para obtener el identificador de un seguimiento existente, use ControlTrace para consultar las propiedades de seguimiento en función del nombre del seguimiento y, a continuación, obtener el identificador del campo Wnode.HistoricalContext de los datos devueltos EVENT_TRACE_PROPERTIES
.
[in] InformationClass
Clase de información que se va a habilitar o deshabilitar. La información que captura la clase se incluye en la sección de datos extendidos del evento. Para obtener una lista de las clases de información que puede habilitar, consulte la enumeración TRACE_QUERY_INFO_CLASS .
[in] TraceInformation
Puntero a datos específicos de la clase de información. La clase de información determina el contenido de este parámetro.
[in] InformationLength
Tamaño, en bytes, de los datos del búfer TraceInformation .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
ERROR_BAD_LENGTH
El programa lanzó un comando pero la longitud del comando es incorrecta. Este error se devuelve si el parámetro InformationLength es menor que un tamaño mínimo.
ERROR_INVALID_PARAMETER
El parámetro no es correcto.
ERROR_NOT_SUPPORTED
No se admite la solicitud.
Otros
Use FormatMessage para obtener la cadena de mensaje del error devuelto.
Comentarios
Llame a esta función después de llamar a StartTrace.
Si el parámetro InformationClass se establece en TraceStackTracingInfo, al llamar a esta función se habilita el seguimiento de la pila de los eventos de kernel especificados. Las llamadas posteriores a esta función sobrescriben la lista anterior de eventos de kernel para los que está habilitado el seguimiento de la pila. Para deshabilitar el seguimiento de la pila, llame a esta función con InformationClass establecido en TraceStackTracingInfo e InformationLength establecido en 0.
La sección de datos extendidos del evento incluirá la pila de llamadas. La StackWalk_Event clase MOF define el diseño de los datos extendidos.
Normalmente, en equipos de 64 bits, no se puede capturar la pila del kernel en determinados contextos cuando no se permiten errores de página. Para habilitar la marcha de la pila del kernel en x64, establezca el valor del DisablePagingExecutive
Registro de administración de memoria en 1. El DisablePagingExecutive
valor del Registro se encuentra bajo la siguiente clave del Registro: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management
.
Esto solo se debe hacer con fines de diagnóstico temporal porque aumenta el uso de memoria del sistema.
Requisitos
Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | evntrace.h |
Library | Sechost.lib en Windows 8.1 y Windows Server 2012 R2; Advapi32.lib en Windows 8, Windows Server 2012, Windows 7 y Windows Server 2008 R2 |
Archivo DLL | Sechost.dll en Windows 8.1 y Windows Server 2012 R2; Advapi32.dll en Windows 8, Windows Server 2012, Windows 7 y Windows Server 2008 R2 |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de