IActiveIMMApp::AssociateContext method

Associates the specified input context with the specified window.

Syntax

HRESULT AssociateContext(
  [in]  HWND hWnd,
  [in]  HIMC hIME,
  [out] HIMC *phPrev
);

Parameters

  • hWnd [in]
    A handle of the window to associate with the input context.

  • hIME [in]
    A handle to the input context. If hIME is NULL, the method removes any association the window might have with an input context.

  • phPrev [out]
    The address of the handle to the input context that was associated previously with the window.

Return value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method maps to the ImmAssociateContext function that is documented in the Windows Software Development Kit (SDK).

By default, the system associates the default input context with each window as it is created.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 5.0

Header

Dimm.h

IDL

Dimm.idl

See also

IActiveIMMApp