IInputMethod::SetImData

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.

This method is implemented to respond to an application's request to set input method (IM)-specific data within the IM.

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 Values

An appropriate HRESULTvalue is returned.

Remarks

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

On Windows CE for the Palm-size PC, the 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

Runs On	Versions	Defined in	Include	Link to
Windows CE OS	2.01 and later	Sip.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.