Esta documentación está archivada y no tiene mantenimiento.

Ejemplo ATLTraceTool: muestra los resultados de ATLTRACE2

Visual Studio 2005

Download sample

El ejemplo ATLTraceTool genera una aplicación que especifica qué mensajes de ATLTRACE2 aparecen en la ventana de resultados. Esta aplicación, la Herramienta de seguimiento de ATL, muestra mensajes de seguimiento de depuración en los orígenes ATL y MFC. Puede controlar el tipo y la cantidad de mensajes que se muestran.

AtlTraceTool.exe se suministra con Visual Studio.NET y se puede encontrar en el directorio Microsoft Visual Studio .NET 2003\Common7\Tools directory. AtlTraceTool.exe también se encuentra disponible en el menú Herramientas, en el entorno de desarrollo.

Security noteNota de seguridad

Este código de ejemplo se proporciona para ilustrar un concepto y no debe utilizarse en aplicaciones o sitios Web, ya que quizás no ilustre las prácticas de codificación más seguras. Microsoft no asume ninguna responsabilidad por daños incidentales o consecuentes en caso de que el código de ejemplo se utilice para propósitos distintos de aquellos para los que se concibió.

Generar y ejecutar el ejemplo

Para generar y ejecutar este ejemplo

  1. Abra el archivo de solución tracetool.sln.

  2. En el menú Generar, haga clic en Generar.

  3. En el menú Depurar, haga clic en Iniciar sin depurar.

NoteNota

Este procedimiento es opcional. Puede utilizar el archivo AtlTraceTool.exe ya generado si lo desea.

Para utilizar ATLTraceTool.exe

  1. Depure un proyecto MFC o ATL haciendo clic en Iniciar en el menú Depurar.

  2. En el menú Herramientas, haga clic en Herramienta de seguimiento de ATL/MFC si no se está ejecutando.

  3. Expanda la lista de control del árbol en la ventana Lista de seguimiento. La ventana muestra la aplicación en ejecución, cualquier módulo de esa aplicación y las categorías de seguimiento para cada módulo.

  4. Personalice, para cada proceso, módulo y categoría, qué información se debe mostrar en la ventana de resultados. El control Nivel de seguimiento del grupo Proceso está relacionado con el nivel ATLTRACE2; sólo los mensajes ATLTRACE2 con un nivel igual o superior que el valor del control Nivel de seguimiento se mostrarán en la ventana de resultados.

  5. Haga clic en Aplicar para activar los valores de configuración.

Puede guardar los valores de configuración y cargarlos la próxima vez que depure la aplicación; utilice los botones Guardar y Cargar.

Interfaz de usuario de la Herramienta de seguimiento de ATL

Lista de seguimiento

Control de árbol con una lista de procesos que utilizan orígenes ATL y MFC En cada proceso, se enumeran los módulos y, debajo de cada módulo, las categorías de seguimiento.

Actualizar

Actualiza la lista de procesos y módulos de Lista de seguimiento.

Grupo Proceso

Configuración durante el proceso:

Nivel de seguimiento: equivale al parámetro de nivel de seguimiento en llamadas a ATLTRACE2. Actualmente, los orígenes ATL y MFC utilizan un nivel de seguimiento de 0-4, donde 0 es el nivel más crítico.

Habilitado: habilita el seguimiento del proceso.

Nombres de categoría y función: incluye la categoría de seguimiento y el nombre de función en los mensajes de seguimiento.

Nombre de archivo y número de línea: incluye el nombre de archivo y el número de línea de los mensajes de seguimiento.

Grupo Módulo

Debe seleccionar un módulo en el control de árbol Lista de seguimiento antes de habilitar el grupo. Esta configuración afecta al módulo.

Nivel de seguimiento: equivale al parámetro de nivel de seguimiento en llamadas a ATLTRACE2. Actualmente, los orígenes ATL y MFC utilizan un nivel de seguimiento de 0-4, donde 0 es el nivel más crítico.

Heredar de proceso: permite configuración de seguimiento en el grupo Proceso para utilizarla también con este módulo.

Habilitado: habilita el seguimiento del módulo.

Deshabilitado: deshabilita el seguimiento del módulo.

Grupo Categoría

Debe seleccionar una categoría en el control de árbol Lista de seguimiento antes de habilitar el grupo. Esta configuración afecta a la categoría del módulo.

Nivel de seguimiento: equivale al parámetro de nivel de seguimiento en llamadas a ATLTRACE2. Actualmente, los orígenes ATL y MFC utilizan un nivel de seguimiento de 0-4, donde 0 es el nivel más crítico.

Heredar de módulo: permite configuración de seguimiento en el grupo Module para utilizarla también con esta categoría.

Habilitado: habilita el seguimiento de esta categoría.

Deshabilitado: deshabilita el seguimiento de esta categoría.

Guardar

Guarda la configuración del proceso actual y de todos los módulos que contiene en un archivo .trc. El archivo .trc se puede cargar utilizando el botón Cargar o llamando a AtlTraceLoadSettings desde el proyecto. Si el archivo .trc se encuentra en el mismo directorio que el EXE o la DLL, puede llamar a AtlTraceLoadSettings y pasar un valor NULL para el nombre de archivo.

Cargar

Carga un archivo .trc.

Aplicar

Aplica la configuración actual al proceso cargado.

Cerrar

Cierra el cuadro de diálogo Herramienta de seguimiento de ATL/MFC. Los cambios no surtirán efecto si no selecciona Aplicar.

Ayuda

Muestra la Ayuda.

Vea también

Otros recursos

Ejemplos de ATL

Mostrar: