InternalGetWindowText 函数 (winuser.h)

项目
03/13/2024

[此函数不用于常规用途。在 Windows 的后续版本中，它可能已更改或不可用。]

如果指定窗口的标题栏 (文本) 复制到缓冲区中。

此函数类似于 GetWindowText 函数。但是，它直接从与指定窗口的句柄关联的窗口结构获取窗口文本，然后始终将文本作为 Unicode 字符串提供。这与 GetWindowText 不同，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。

注解

在具有 Service Pack 1 的 Windows XP (SP1) 和 Windows Server 2003 之前，此函数未包含在 SDK 标头和库中。如果没有此函数的头文件和导入库，可以使用 LoadLibrary 和 GetProcAddress 调用该函数。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll