Indica o destino da saída despejo. Valores possíveis, que podem ser combinados usando o operador bit a bit ou (|), são os seguintes:
AFX_STACK_DUMP_TARGET_TRACE Envia saída por meio a macro de Rastrear . A macro de Rastrear gera saída em compilações de Depurar apenas; Ele não gera nenhuma saída em versão cria. Além disso, Rastrear pode ser redirecionada para outros destinos além do depurador.
AFX_STACK_DUMP_TARGET_DEFAULT Envia saída para o destino padrão de despejo. Para uma compilação de Depurar, a saída vai para a macro de Rastrear . Em uma compilação de versãosão, a saída vai para a área de transferência.
AFX_STACK_DUMP_TARGET_CLIPBOARD Envia saída para a área de transferência só. Os dados serão colocados na área de transferência como texto sem formatação usando o Formatarar de área de transferência CF_TEXT.
AFX_STACK_DUMP_TARGET_BOTH Envia saída para a área de transferência e a macro Rastrear , simultaneamente.
AFX_STACK_DUMP_TARGET_ODS Envia saída diretamente para o depurador por meio de função de Win32 Deafx_stack_dump_target_ods. Esta opção irá gerar saída do depurador em ambos os Depurar e versão compilações quando um depurador é anexado ao processo. Saída sempre atinge o depurador (se ela estiver conectada) e não pode ser redirecionada.
Observações
Esta função global pode ser usada para gerar uma imagem da pilha atual. O exemplo a seguir reflete uma única linha da saída gerada a partir de chamar AfxDumpStack de um manipulador de botão em um applicaton de diálogo do MFC:
A tabela a seguir descreve o acima linha de saída:
Saída
Descrição
BFF928E0:
O endereço de retorno da Último chamada de função.
WINDOWS\SYSTEM\KERNEL32.DLL!
O nome de caminho completo do módulo que contém a chamada de função.
UTUnRegister
O protótipo de função chamado.
+ 2492 bytes
O deslocamento em bytes do endereço do protótipo de função (neste caso, UTUnRegister ) para o endereço de retorno (neste caso, BFF928E0 ).
AfxDumpStack está disponível em versões de depuração e nondebug das bibliotecas MFC; no entanto, a função está sempre vinculada estaticamente, mesmo quando seu arquivo executável usa MFC em uma DLL compartilhada. Em implementações de biblioteca compartilhada, a função é encontrada no MFCS42.LIB biblioteca (e suas variantes).
Para usar essa função com êxito:
O arquivo IMAGEHLP.DLL deve estar no seu caminho. Se você não tiver essa DLL, a função exibirá uma mensagem de erro. IMAGEHLP.DLL é uma DLL redistribuível fornecido com o SDK do Win32 e Windows. Procurá-lo na C:\[windows]\system[32]. Consulte Manipulação de arquivo executável portátil para obter uma introdução para o conjunto de função fornecido pelo IMAGEHLP.
Os módulos que tem quadros na pilha devem incluir informações de depuração. Se eles não contêm informações de depuração, a função ainda gerará um Rastrear de pilha, mas o rastreamento serão menos detalhado.