Función OutputDebugStringW (debugapi.h)

Envía una cadena al depurador para que la muestre.

Sintaxis

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

Parámetros

[in, optional] lpOutputString

Cadena terminada en null que se va a mostrar.

Valor devuelto

None

Observaciones

Importante

Para usar esta función, debe incluir el encabezado Windows.h en la aplicación (no debugapi.h).

En el pasado, el sistema operativo no devolvió cadenas Unicode a través de OutputDebugStringW (en su lugar se devolvieron cadenas ASCII). Para forzar a OutputDebugStringW a devolver cadenas Unicode, los depuradores deben llamar a la función WaitForDebugEventEx para participar en el nuevo comportamiento. De este modo, el sistema operativo sabe que el depurador admite Unicode y está optando específicamente por recibir cadenas Unicode.

Si la aplicación no tiene un depurador y la máscara de filtro lo permite, el depurador del sistema muestra la cadena. Para mostrar la cadena, esta función llama a la función DbgPrint . Antes de Windows Vista, el depurador del sistema no filtre el contenido.

Si la aplicación no tiene un depurador y el depurador del sistema no está activo, OutputDebugString no hace nada.

OutputDebugStringW convierte la cadena especificada en función de la información de configuración regional del sistema actual y la pasa a OutputDebugStringA para que se muestre. Como resultado, es posible que algunos caracteres Unicode no se muestren correctamente.

Las aplicaciones deben enviar una salida de depuración muy mínima y proporcionar una manera para que el usuario habilite o deshabilite su uso. Consulte Seguimiento de eventos para obtener más información sobre los detalles de seguimiento.

Visual Studio ha cambiado la forma en que controla la presentación de estas cadenas a lo largo de su historial de revisiones. Consulte la documentación de Visual Studio para obtener más información sobre cómo se ocupa la versión.

El encabezado debugapi.h define OutputDebugString como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede provocar errores de coincidencia y compilación o errores en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	debugapi.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

Comunicación con el depurador

Funciones de depuración

API de Vertdll disponibles en enclaves de VBS