CeGetWindowText (RAPI)
This function copies the text of the specified window's title bar — if it has one — into a buffer. If the specified window is a control, the text of the control is copied.
CeGetWindowText is a remote application interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.
int CeGetWindowText(
HWND hWnd,
LPTSTR lpString,
int nMaxCount);
Parameters
- hWnd
Handle to the window or control containing the text. - lpString
Long pointer to the buffer that will receive the text. - nMaxCount
Specifies the maximum number of characters to copy to the buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Return Values
The length, in characters, of the copied string, not including the terminating null character, indicates success. Zero indicates that the window has no title bar or text, if the title bar is empty, or if the window or control handle is invalid. To get extended error information, call CeGetLastError.
This function cannot retrieve the text of an edit control in another application.
Remarks
When working with RAPI for Windows CE versions 1.0 and 1.01, use the PegGetWindowText function.
Requirements
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.0 and later | Rapi.h |
See Also
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.