Indica el destino de la salida de volcado. Los valores posibles, que se pueden combinar mediante el operador OR bit a bit (|), son los siguientes:
AFX_STACK_DUMP_TARGET_TRACE Envía la salida a través de la macro TRACE . La macro TRACE genera salida en versiones de depuración sólo; no genera ningún resultado en versiones de lanzamiento. Además, TRACE pueden redirigirse a otros objetivos aparte del depurador.
AFX_STACK_DUMP_TARGET_DEFAULT Envía volcado de salida para el destino por defecto. Para una versión de depuración, la salida va a la macro TRACE . En una versión de compilación, la salida va al Portapapeles.
AFX_STACK_DUMP_TARGET_CLIPBOARD Envía salida en el Portapapeles sólo. Los datos se colocan en el Portapapeles como texto usando el formato de Portapapeles CF_TEXT.
AFX_STACK_DUMP_TARGET_BOTH Envía salida en el Portapapeles y la macro TRACE , simultáneamente.
AFX_STACK_DUMP_TARGET_ODS Envía salida directamente al depurador mediante la función de Win32 OutputDebugString(). Esta opción generará salida de depurador en ambos debug y suelte construye cuando un depurador está asociado al proceso. AFX_STACK_DUMP_TARGET_ODS siempre llega el depurador (si está conectada) y no puede ser Redirigido.
Observaciones
Esta función global puede utilizarse para generar una imagen de la pila actual. El ejemplo siguiente refleja una sola línea de la salida generada de llamar a AfxDumpStack desde un controlador de botón en una aplicación de cuadro de diálogo MFC:
La tabla siguiente describe la anterior línea de salida:
Salida
Descripción
BFF928E0:
La dirección de retorno de la última llamada de función.
¡WINDOWS\SYSTEM\KERNEL32.DLL!
El nombre de ruta de acceso completa del módulo que contiene la llamada a la función.
UTUnRegister
El prototipo de función llamado.
+ 2492 bytes
El desplazamiento en bytes de la dirección de la función prototipo (en este caso, UTUnRegister ) a la dirección de retorno (en este caso, BFF928E0 ).
AfxDumpStack está disponible en las versiones de depuración y nondebug de las bibliotecas MFC; Sin embargo, la función es siempre vinculada estáticamente, incluso cuando el archivo ejecutable utiliza MFC en una DLL compartida. En las implementaciones de biblioteca compartida, la función se encuentra en la MFCS42.Biblioteca LIB (y sus variantes).
Para utilizar esta función con éxito:
El archivo IMAGEHLP.DLL debe estar en su camino. Si no tienes esta DLL, la función mostrará un mensaje de error. IMAGEHLP.DLL es una DLL redistribuible que se suministra con el SDK de Win32 y con Windows. Buscar en C:\[windows]\system[32]. Ver Manipulación de archivo ejecutable Portable para obtener una introducción al conjunto de función proporcionada por IMAGEHLP.
Los módulos que tienen los marcos de la pila deben incluir información de depuración. Si no contienen información de depuración, la función generará todavía un seguimiento de la pila, pero la traza se detallarán menos.