InternalGetWindowText 函式 (winuser.h)

發行項
03/04/2024

[此函式不適用於一般用途。它可能會在後續版本的 Windows 中改變或無法使用。

如果指定視窗的標題列有一個) ，則會將指定視窗標題 (欄的文字複製到緩衝區中。

此函式類似於 GetWindowText 函式。不過，它會直接從與指定視窗句柄相關聯的窗口結構取得視窗文字，然後一律以 Unicode 字串的形式提供文字。這不同於 GetWindowText ，它會透過傳送視窗 WM_GETTEXT 訊息來取得文字。如果指定的視窗是控制件，則會取得控制件的文字。

語法

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

參數

[in] hWnd

類型： HWND

包含文字之視窗或控件的句柄。

[out] pString

類型： LPWSTR

要接收文字的緩衝區。

如果字串長度或超過緩衝區，則會以 Null 字元截斷字串並終止。

[in] cchMaxCount

類型： int

要複製到緩衝區的最大字元數，包括 Null 字元。如果文字超過此限制，則會被截斷。

傳回值

類型： int

如果函式成功，則傳回值是複製字串的長度，不包含終止的 Null 字元。

如果視窗沒有標題列或文字、標題列是空的，或是視窗或控件句柄無效，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

在 Windows XP 搭配 Service Pack 1 (SP1) 和 Windows Server 2003 之前，SDK 標頭和連結庫中未包含此函式。如果您沒有頭文件並匯入此函式的連結庫，您可以使用 LoadLibrary 和 GetProcAddress 呼叫函式。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll