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 is called by the input method (IM) to send an entire string to the window that currently has the focus; that is, the window that would have received keyboard input if a key had been pressed on an external keyboard.

Syntax 

HRESULT SendString( 
  LPTSTR 
ptszStr, 
  DWORD 
dwSize
);

Parameters

ptszStr

Pointer to a string buffer containing the string to send.

dwSize

Specifies the number of characters in the buffer. This number should not include the terminating null character, which is not sent.

Return Value

An appropriate HRESULTvalue is returned.

Remarks

An IM uses this method after an entire word or sentence has been entered. For example, a character recognizer IM could call this method after the user enters a full word. The software-based input panel sends each character in the buffer as a WM_CHARmessage to the current application. You can also use IIMCallback2::SendCharEventsand IIMCallback2::SendVirtualKeyto send characters to the current application.

Requirements

Header sip.h
Library uuid.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also