Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method 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. The specified window must be on a Windows Embedded CE–based remote device.

Syntax

int CeGetWindowText (
  HWND 
hWnd, 
  LPWSTR 
lpString, 
  int 
nMaxCount 
);

Parameters

hWnd

[in] Handle to the window or control containing the text.

lpString

[in, out] Long pointer to the buffer that will receive the text.

nMaxCount

[in] 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 Value

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 IRAPISession::CeGetLastErrorand IRAPISession::CeRapiGetError.

This method cannot retrieve the text of an edit control in another application.

Requirements

Header rapi2.h
Library ole32.lib, rapiuuid.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also