IActiveIMMIME::AssociateContext method

  • Article

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 to 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 had 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

IActiveIMMIME