Indique la cible de la sortie du dump. Voici les valeurs possibles, qui peuvent être combinés en utilisant l'opérateur de bits OR (|),:
AFX_STACK_DUMP_TARGET_TRACE ; Envoie la sortie via la macro TRACE . La macro TRACE génère une sortie dans les versions de débogage uniquement ; Il ne génère aucune sortie dans Communiqué de builds. En outre, TRACE peuvent être redirigés vers d'autres objectifs en dehors du débogueur.
AFX_STACK_DUMP_TARGET_DEFAULT ; Envoie dump sortie vers la cible par défaut. Pour une version Debug, sortie va à la macro TRACE . Dans une version release, sortie va vers le presse-papiers.
AFX_STACK_DUMP_TARGET_CLIPBOARD ; Envoie la sortie vers le presse-papiers uniquement. Les données sont placées dans le presse-papiers sous forme de texte brut en utilisant le format de presse-papiers CF_TEXT.
AFX_STACK_DUMP_TARGET_BOTH ; Envoie la sortie vers le presse-papiers et à la macro TRACE , en même temps.
AFX_STACK_DUMP_TARGET_ODS ; Envoie la sortie directement dans le débogueur via la fonction Win32 OutputDebugString(). Cette option génère sortie du débogueur dans les deux versions debug et release construit lorsqu'un débogueur est attaché au processus de. AFX_STACK_DUMP_TARGET_ODS a toujours atteint le débogueur (si il est attaché) et ne peut pas être redirigé.
Remarques
Cette fonction globale peut être utilisée pour générer une image de la pile en cours. L'exemple ci-dessous reflète une seule ligne de la sortie générée d'appeler AfxDumpStack un gestionnaire d'événements de bouton dans une application de boîte de dialogue MFC:
=== commencer AfxDumpStack sortie ===
…
BFF928E0 : WINDOWS\SYSTEM\KERNEL32.DLL ! UTUnRegister + 2492 octets
=== fin de sortie AfxDumpStack() ===
Le tableau suivant décrit la ligne au-dessus de la sortie:
Sortie
Description
BFF928E0:
L'adresse de retour du dernier appel de fonction.
WINDOWS\SYSTEM\KERNEL32.DLL!
Le nom de chemin d'accès complet du module qui contient l'appel de fonction.
UTUnRegister
Prototype de la fonction appelé.
+ 2492 octets
Le décalage en octets de l'adresse du prototype de la fonction (dans ce cas, UTUnRegister ) à l'adresse de retour (dans ce cas, BFF928E0 ).
AfxDumpStack est disponible dans les versions debug et non Debug des bibliothèques MFC ; Cependant, la fonction est toujours liée statiquement, même lorsque votre fichier exécutable utilise MFC dans une DLL partagée. Dans les implémentations de bibliothèque partagée, la fonction se trouve dans le MFCS42.Bibliothèque LIB (et ses variantes).
Pour utiliser cette fonction avec succès:
Le fichier IMAGEHLP.DLL doit être sur votre chemin. Si vous n'avez pas cette DLL, la fonction affiche un message d'erreur. IMAGEHLP.DLL est une DLL redistribuable qui est livré avec le Kit de développement Win32 et Windows. Chercher dans C:\[windows]\system[32]. Voir Manipulation de fichier exécutable Portable pour une introduction à l'ensemble de la fonction fournie par IMAGEHLP.
Les modules qui ont des cadres sur la pile doivent inclure des informations de débogage. Si elles ne contiennent pas d'informations de débogage, la fonction génère toujours une trace de la pile, mais la trace va être moins détaillée.