Função OutputDebugStringA (debugapi.h)
Envia uma cadeia de caracteres para o depurador para exibição.
Sintaxe
void OutputDebugStringA(
[in, optional] LPCSTR lpOutputString
);
Parâmetros
[in, optional] lpOutputString
A cadeia de caracteres terminada em nulo a ser exibida.
Valor retornado
Nenhum
Comentários
Importante
Para usar essa função, você deve incluir o cabeçalho Windows.h em seu aplicativo (não debugapi.h).
No passado, o sistema operacional não retornava cadeias de caracteres Unicode por meio de OutputDebugStringW (as cadeias de caracteres ASCII eram retornadas em vez disso). Para forçar OutputDebugStringW a retornar cadeias de caracteres Unicode, os depuradores são obrigados a chamar a função WaitForDebugEventEx para aceitar o novo comportamento. Dessa forma, o sistema operacional sabe que o depurador dá suporte ao Unicode e está optando especificamente por receber cadeias de caracteres Unicode.
Se o aplicativo não tiver um depurador e a máscara de filtro permitir, o depurador do sistema exibirá a cadeia de caracteres. Para exibir a cadeia de caracteres, essa função chama a função DbgPrint . Antes do Windows Vista, o conteúdo não era filtrado pelo depurador do sistema.
Se o aplicativo não tiver um depurador e o depurador do sistema não estiver ativo, OutputDebugString não fará nada.
OutputDebugStringW converte a cadeia de caracteres especificada com base nas informações de localidade do sistema atual e a passa para OutputDebugStringA a ser exibida. Como resultado, alguns caracteres Unicode podem não ser exibidos corretamente.
Os aplicativos devem enviar uma saída de depuração muito mínima e fornecer uma maneira de o usuário habilitar ou desabilitar seu uso. Consulte Rastreamento de Eventos para saber mais sobre detalhes de rastreamento.
O Visual Studio alterou a forma como lida com a exibição dessas cadeias de caracteres ao longo de seu histórico de revisão. Consulte a documentação do Visual Studio para obter detalhes de como sua versão lida com isso.
O cabeçalho debugapi.h define OutputDebugString como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades e erros de compilação ou runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | debugapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |