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

Confira também

Comunicando-se com o Depurador, Funções de Depuração