Ejemplo ATLTraceTool: muestra los resultados de ATLTRACE2

  • Artículo

Actualización: noviembre 2007

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 y se puede encontrar en el directorio \Archivos de programa\Microsoft Visual Studio 9.0\Common7\Tools. AtlTraceTool.exe también se encuentra disponible en el menú Herramientas, en el entorno de desarrollo.

Nota 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ó.

Para obtener ejemplos e instrucciones para su instalación:

  • En el menú Ayuda de Visual Studio, haga clic en Ejemplos.

    Para obtener más información, vea Localizar archivos de ejemplo.

  • La lista de ejemplos completa con la versión más reciente está disponible en línea en la página Visual Studio 2008 Samples.

  • También encontrará ejemplos en el disco duro de su equipo. De manera predeterminada, los ejemplos y el archivo Léame se copian en una carpeta bajo \Archivos de programa\Visual Studio 9.0\Samples\. Para las versiones Express de Visual Studio, todos los ejemplos están en línea.

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.

Nota:

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