Share via


IRAPISession::CeGetWindowText

Send Feedback

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 Microsoft® Windows® CE–based remote device.

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

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

Requirements

OS Versions: Windows CE 5.01 and later.
Header: Rapi2.h.
Link Library: Ole32.lib, Rapiuuid.lib

See Also

IRAPISession::IUnknown | IRAPISession::CeGetWindow| IRAPISession::CeGetWindowLong

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.