### 函数功能

该函数返回指定窗口的标题文本（如果存在）的字符长度。如果指定窗口是一个控制，函数将返回控制内文本的长度。但是GetWindowTextLength函数不能返回在其他应用程序中的控制的文本长度。

### 函数原型

nit GetWindowTextLent（HWND hWnd）；

### 参数

hWnd：窗口或控制的句柄。

### 返回值

如果函数成功，返回值为文本的字符长度。在一定的条件下，返回值可能比实际的文本长度大。请参看说明。如果窗口无文本，返回值为零。若想获得更多错误信息，请调用GetLastError函数。
备注：如果目标窗口属于当前进程，GetWindowTextLength函数给指定的窗口或控制发送WM_GETTEXT消息。
在一定的条件下，函数GetWindowTextLength的返回值可能比实际的文本长度大。这是由于ANSI和Unlcode的混和使用以及系统允许DBCS字符在文本内存在的原因，但是函数返回值要至少与文本的实际长度相等，因此可以利用这一点指导缓存区的分配。在应用程序既使用ANSI函数又使用Unicode的普通对话框时就会有缓存分配的问题；同样，当应用程序在一个Unicode的窗口过程中使用了ANSI的GetWindowTextLength函数，或在一个ANSI的窗口过程中使用了Unicode的GetWindowTextLength函数的时候也有缓存分配的问题。查看ANSI和Vnicode函数，参考Wind32函数prototypes。
要获得文本的实际长度，使用WM_GETTEXT, LB_GETTEXT或CB_GETLBTBTEXT消息或GetWindowText函数。

### 速查

Windows NT：3.1以上版本：Windows：95以上版本：Windows CE：1.0以上版本；头文件：Winuser.h；库文件：user32.lib;Unicode：在Windows NT上实现为山Unicode和ANSI两种版本。