Share via


IInputMethod3::SetImData (Compact 2013)

3/28/2014

Implement this method to respond to an application's request to set input method-specific data within the input method.

Syntax

HRESULT SetImData(
  DWORD dwSize,
  void* pvImData
);

Parameters

  • dwSize
    [in] Size of the buffer pointed to by pvImData.
  • pvImData
    [in] Void pointer to a data buffer in the application.

Return Value

Returns S_OK to indicate success; otherwise, returns the appropriate HRESULT value to indicate that it was not successful.

Remarks

Use this method with IInputMethod3::GetImData to send data between an input method and an application. The application provides the data for the input method. The size and format of the data are defined by the input method.

In Windows Embedded Compact, the software-based input panel (SIP) calls SetImInfo when an application requests to alter input method-specific information by using the SipSetInfo function. The application provides a non-null pointer for the pvImData member of the SIPINFO structure. The application can then pass information directly to the input method.

Requirements

Header

sip.h

Library

uuid.lib

sysgen

SYSGEN_SOFTKB

See Also

Reference

IInputMethod3
SipSetInfo
SIPINFO
IInputMethod3::Deselect
IInputMethod3::GetInfo
IInputMethod3::Hiding
IInputMethod3::InputContextChange
IInputMethod3::ReceiveSipInfo
IInputMethod3::RegisterCallback
IInputMethod3::RegisterCallback2
IInputMethod3::RegisterCallback3
IInputMethod3::Select
IInputMethod3::SetIMMActiveContext
IInputMethod3::Showing
IInputMethod3::UserOptionsDlg