Fungsi InternalGetWindowText (winuser.h)

Artikel
03/04/2024

[Fungsi ini tidak ditujukan untuk penggunaan umum. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]

Menyalin teks bilah judul jendela yang ditentukan (jika memilikinya) ke dalam buffer.

Fungsi ini mirip dengan fungsi GetWindowText . Namun, ia mendapatkan teks jendela langsung dari struktur jendela yang terkait dengan handel jendela yang ditentukan dan kemudian selalu menyediakan teks sebagai string Unicode. Ini tidak seperti GetWindowText yang mendapatkan teks dengan mengirim pesan WM_GETTEXT ke jendela. Jika jendela yang ditentukan adalah kontrol, teks kontrol diperoleh.

Sintaks

int InternalGetWindowText(
  [in]  HWND   hWnd,
  [out] LPWSTR pString,
  [in]  int    cchMaxCount
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela atau kontrol yang berisi teks.

[out] pString

Jenis: LPWSTR

Buffer yang akan menerima teks.

Jika string selama atau lebih panjang dari buffer, string dipotok dan dihentikan dengan karakter null.

[in] cchMaxCount

Jenis: int

Jumlah maksimum karakter yang akan disalin ke buffer, termasuk karakter null. Jika teks melebihi batas ini, teks akan terpotok.

Nilai kembali

Jenis: int

Jika fungsi berhasil, nilai yang dikembalikan adalah panjang, dalam karakter, dari string yang disalin, tidak termasuk karakter null yang mengakhiri.

Jika jendela tidak memiliki bilah judul atau teks, jika bilah judul kosong, atau jika jendela atau handel kontrol tidak valid, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini tidak disertakan dalam header dan pustaka SDK hingga Windows XP dengan Paket Layanan 1 (SP1) dan Windows Server 2003. Jika Anda tidak memiliki file header dan pustaka impor untuk fungsi ini, Anda dapat memanggil fungsi menggunakan LoadLibrary dan GetProcAddress.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll