ATLTRACE2
Advertencias de los informes en un dispositivo de salida, como la ventana del depurador, según los marcadores y los niveles indicados.
ATLTRACE2( exp );
ATLTRACE2(
DWORD category,
UINT level,
LPCSTR lpszFormat,
...
);
Parámetros
exp
[in] La cadena para enviar a Visual C++ la ventana de resultados o cualquier aplicación que captura estos mensajes.category
[in] Tipo de evento o de método en el que el informe. Vea las notas para obtener una lista de categorías.level
[in] El nivel de seguimiento a comunicar. Vea las notas de detalles.lpszFormat
[in] printf- cadena de formato de estilo a utilizar para crear una cadena para enviar al dispositivo de volcado.
Comentarios
La forma abreviada de ATLTRACE2 escribe una cadena en la ventana de salida del depurador. El segundo formato de ATLTRACE2 de escrituras también generadas en la ventana de salida del depurador, pero está sujeto a los valores de la herramienta de seguimiento de ATL/MFC (vea Ejemplo ATLTraceTool). Por ejemplo, si se level establecido en 4 y la herramienta de seguimiento de ATL/MFC y el nivel 0, no ve el mensaje. el nivel puede ser 0, 1, 2, 3, 4. El valor predeterminado, 0, informes sólo la mayoría de los problemas graves.
Las listas de parámetros de category marcas de traza a establecer. Estos marcadores corresponden a los tipos de métodos para los que desea notificar. Las tablas siguientes enumeran las marcas de traza válidos que puede utilizar para el parámetro de category.
Marcas de traza ATL
Categoría de ATL |
Descripción |
|---|---|
atlTraceGeneral |
Informes en todas las aplicaciones de ATL. Es el formato predeterminado. |
atlTraceCOM |
Informes en métodos COM. |
atlTraceQI |
Informes en las llamadas de QueryInterface. |
atlTraceRegistrar |
Informes en el registro de objetos. |
atlTraceRefcount |
Informes en cambiar recuento de referencia. |
atlTraceWindowing |
Informes de métodos de las ventanas; por ejemplo, los informes un mensaje no válido asignan la identificación |
atlTraceControls |
Informes en controles; por ejemplo, informes cuando se destruye un control o la ventana. |
atlTraceHosting |
Informes de hospedaje mensajes; por ejemplo, informes cuando activan un cliente en un contenedor. |
atlTraceDBClient |
Informes de la plantilla de consumidor OLE DB; por ejemplo, cuando una llamada a GetData, el resultado puede contener el HRESULT. |
atlTraceDBProvider |
Informes de la plantilla de proveedor OLE DB; por ejemplo, informes si se produjo un error en la creación de una columna. |
atlTraceSnapin |
Informes para la aplicación de MMC SnapIn. |
atlTraceNotImpl |
Informes que la función indicada no está implementada. |
atlTraceAllocation |
Mensajes de informes impresos por las herramientas de depuración de memoria en atldbgmem.h. |
Marcas de traza de MFC
Categoría de MFC |
Descripción |
|---|---|
traceAppMsg |
Uso general, mensajes de MFC. Recomendado siempre. |
traceDumpContext |
Mensajes de CDumpContext. |
traceWinMsg |
Mensajes del código de control de mensajes MFC. |
traceMemory |
Mensajes de código de administración de memoria de MFC. |
el traceCmdRouting |
Mensajes de código de enrutamiento de comandos de Windows de MFC. |
traceHtml |
Mensajes de soporte de diálogo DHTML MFC. |
traceSocket |
Mensajes de soporte de socket de MFC. |
traceOle |
Mensajes de compatibilidad OLE de MFC. |
traceDatabase |
Mensajes de compatibilidad con bases de datos MFC. |
traceInternet |
Mensajes de soporte de internet de MFC. |
Para declarar una categoría de traza de custom, declare una instancia global de la clase de CTraceCategory como sigue:
CTraceCategory MY_CATEGORY(_T("MyCategoryName"), 1);
El nombre de categoría, MY_CATEGORY en este ejemplo, es el nombre que se especifica a category el parámetro. El primer parámetro es el nombre de categoría que aparecerá en la herramienta de seguimiento de ATL/MFC. El segundo parámetro es el nivel de seguimiento predeterminado. Este parámetro es opcional, y el nivel de seguimiento predeterminado es 0.
Para utilizar una categoría definida por el usuario:
ATLTRACE2(MY_CATEGORY, 2, _T("a message in a custom category"));
Para especificar que desea filtrar mensajes de seguimiento, definiciones de inserción para estas macros en Stdafx.h antes de la instrucción de #include <atlbase.h>.
Alternativamente, puede establecer un filtro en las directivas de preprocesador en el cuadro de diálogo Páginas de propiedades. Haga clic en la pestaña Preprocesador y después inserte el global en el cuadro de edición Definiciones de preprocesador.
Atlbase.h contiene las definiciones predeterminadas de macros de ATLTRACE2 y estas definiciones se usarán si no define estos símbolos antes de que se procese atlbase.h.
En versión de lanzamiento, compila de ATLTRACE2 a (void) 0.
ATLTRACE2 limita el contenido de la cadena que se va a enviar al dispositivo de volcado a no más de 1023 caracteres, después de formatear.
ATLTRACE y ATLTRACE2 tienen el mismo comportamiento, ATLTRACE es incluidos para la compatibilidad con versiones anteriores.
Ejemplo
int i = 1;
ATLTRACE2(atlTraceGeneral, 4, "Integer = %d\n", i);
// Output: 'Integer = 1'
Requisitos
Header: atltrace.h