Função OutputDebugStringW (debugapi.h)

Envia uma cadeia de caracteres para o depurador para exibição.

Sintaxe

void OutputDebugStringW(
  [in, optional] LPCWSTR lpOutputString
);

Parâmetros

[in, optional] lpOutputString

A cadeia de caracteres terminada em nulo a ser exibida.

Retornar valor

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). Para forçar OutputDebugStringW a retornar cadeias de caracteres Unicode, os depuradores precisam chamar a função WaitForDebugEventEx para aceitar o novo comportamento. Dessa forma, o sistema operacional sabe que o depurador dá suporte a 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 para 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 em todo o 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. Misturar o 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

Requisito	Valor
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

APIs Vertdll disponíveis em enclaves de VBS