Fungsi OutputDebugStringA (debugapi.h)

Mengirim string ke debugger untuk ditampilkan.

Sintaks

void OutputDebugStringA(
  [in, optional] LPCSTR lpOutputString
);

Parameter

[in, optional] lpOutputString

String null-terminated yang akan ditampilkan.

Nilai kembali

Tidak ada

Keterangan

Penting

Untuk menggunakan fungsi ini, Anda harus menyertakan header Windows.h dalam aplikasi Anda (bukan debugapi.h).

Di masa lalu, sistem operasi tidak mengembalikan string Unicode melalui OutputDebugStringW (string ASCII dikembalikan sebagai gantinya). Untuk memaksa OutputDebugStringW mengembalikan string Unicode, debugger diperlukan untuk memanggil fungsi WaitForDebugEventEx untuk memilih perilaku baru. Dengan cara ini, sistem operasi tahu bahwa debugger mendukung Unicode dan secara khusus memilih untuk menerima string Unicode.

Jika aplikasi tidak memiliki debugger, dan filter mask memungkinkannya, debugger sistem menampilkan string. Untuk menampilkan string, fungsi ini memanggil fungsi DbgPrint . Sebelum Windows Vista, konten tidak difilter oleh debugger sistem.

Jika aplikasi tidak memiliki debugger dan debugger sistem tidak aktif, OutputDebugString tidak melakukan apa pun.

OutputDebugStringW mengonversi string yang ditentukan berdasarkan informasi lokal sistem saat ini dan meneruskannya ke OutputDebugStringA untuk ditampilkan. Akibatnya, beberapa karakter Unicode mungkin tidak ditampilkan dengan benar.

Aplikasi harus mengirim output debug yang sangat minimal dan menyediakan cara bagi pengguna untuk mengaktifkan atau menonaktifkan penggunaannya. Lihat Pelacakan Peristiwa untuk mempelajari selengkapnya tentang detail pelacakan.

Visual Studio telah mengubah caranya menangani tampilan string ini di seluruh riwayat revisinya. Lihat dokumentasi Visual Studio untuk detail tentang bagaimana versi Anda menangani hal ini.

Header debugapi.h mendefinisikan OutputDebugString sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak netral pengodean dapat menyebabkan ketidakcocokan dan kompilasi atau kesalahan runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	debugapi.h (sertakan Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Berkomunikasi dengan Debugger, Debugging Functions