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 implemented to respond to an application's request to set input method (IM)-specific data within the IM.

Syntax 

HRESULT SetImData( 
  DWORD 
dwSize, 
  void* 
pvImData
);

Parameters

dwSize

Specifies the size of the buffer pointed to by pvImData.

pvImData

Void pointer to a data buffer in the application. The application is providing information for the IM. The size and format of the data are defined by the IM.

Return Value

Return S_OK to indicate success. Return the appropriate HRESULTvalue to indicate failure.

Remarks

Use this method and IInputMethod::GetImDatato send data to and from an application.

On Windows Embedded CE, the software-based input panel calls SetImInfowhen an application has asked to alter IM-specific information in the SipSetInfofunction. This is done by the application providing a non-null pointer for the pvImDatamember of the SIPINFOstructure. The application can then pass information directly to the IM.

Requirements

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

See Also