ATLTRACE2 (DWORD categoría, UINT nivel, LPCSTR lpszFormat,...)
Parámetros
categoría
[en] El atlTraceFlags , para indicar el tipo de evento o método en el que informe. Vea la sección comentarios para obtener una lista de categorías.
nivel
[en] El nivel de seguimiento al informe. Debe ser menor o igual que el valor establecido para que ATL_TRACE_LEVEL a aparecer. Por ejemplo, si establece el nivel 4 y ATL_TRACE_LEVEL en 0, no se verá advertencias. Vea la sección comentarios para obtener más información acerca de ATL_TRACE_LEVEL.
lpszFormat
[en] La cadena con formato para enviar a dispositivo de volcado.
Observaciones
Utilice ATLTRACE2 para fi&nes de depuración. ATLTRACE2 proporciona mensajes acerca de cómo happen.nbsp eventos y métodos; ATLTRACE2 informes de advertencias y errores que se producen como depurar el programa. ATLTRACE2 envía una cadena con formato, lpszFormat, a un dispositivo de volcado, generalmente la ventana salida del depurador o un archivo.
El primer parámetro para ATLTRACE2, categoría, muestra los indicadores de seguimiento para establecer. Estos indicadores se corresponden con los tipos de métodos para el que desea informar. La tabla siguiente muestra los indicadores de seguimiento válido que se puede utilizar para el parámetro de categoría.
| Categoría | Descripción |
| atlTraceUser | Definido por la aplicación. El valor indica el nivel de advertencias al informe. |
| atlTraceGeneral | Informes sobre todas las aplicaciones de ATL. El valor predeterminado. |
| atlTraceCOM | Informes sobre métodos COM. |
| atlTraceQI | Informes sobre llamadas a QueryInterface. |
| atlTraceRegistrar | Informes sobre el registro de objetos. |
| atlTraceRefcount | Informes sobre el cambio de recuento de referencias. |
| atlTraceWindowing | Informes sobre métodos de windows, por ejemplo informes de un ID de mapa de mensaje no válido. |
| atlTraceControls | Informes sobre los controles, por ejemplo los informes cuando se destruye un control o su ventana. |
| atlTraceHosting | Informes de hospedaje mensajes, por ejemplo, cuando se activa un cliente en un contenedor. |
| atlTraceDBClient | Informes sobre plantillas de consumidor OLE DB; por ejemplo cuando una llamada al método GetData falla, la salida puede contener el valor HRESULT. |
| atlTraceDBProvider | Informes sobre la plantilla de proveedor OLE DB, por ejemplo los informes si ha fallado la creación de una columna. |
| atlTraceSnapin | Informes de aplicación de complemento de MMC. |
| atlTraceNotImpl | Informes que no se ha implementado la función indicada. |
Ejemplo
/ / ejemplo de ATLTRACE2
int i = 1;
ATLTRACE2 (atlTraceGeneral, 4, "Integer = %s\n", i);
/ / Salida: ' Integer = 1'
Puede filtrar por categorías específicas y los niveles de nivel de proyecto estableciendo las dos funciones globales descritas a continuación. Para especificar dicha filtración en las definiciones del preprocesador, insertar las funciones globales en Stdafx.h antes de la #include lt;atlbase.h> declaración.
Alternativamente, puede establecer el filtro en las directivas de preprocesador en el cuadro de diálogo deajustes de proyecto. Haga clic en la ficha de C o C++ y, a continuación, insertar el Mundial en el cuadro de edición de definiciones del preprocesador .
Para establecer las categorías y niveles, utilice las siguientes funciones globales:
ATL_TRACE_CATEGORY 0XFFFFFFFF
Establece la categoría de seguimiento para el que desea filtrar. Por defecto, 0xFFFFFFFF informes de todas las categorías. Para filtrar una categoría específica o un conjunto de categorías, reemplazar 0xFFFFFFFF con los nombres de categoría que desea rastrear. Puede utilizar el OR bit a bit (|) operador para filtrar por más de una categoría. Por ejemplo, mediante el establecimiento de ATL_TRACE_CATEGORY (atlTraceControls | atlTraceWindowing), verá sólo ATLTRACE2 advertencias para controles y ventanas.
ATL_TRACE_LEVEL 0
Establece el nivel de seguimiento que desee filtrar. Puede ser 0, 1, 2, 3 o 4. Por defecto, 0, informes sólo los problemas más graves. Reemplazar a 0 con el nivel de información que desea ver. Por ejemplo, especificando 4, verá todos los niveles de las advertencias y mensajes informativos.
ATL Macros y funciones globales
Véase también