IActiveIMMIME::AssociateContext Method

---

Associates the specified input context with the specified window.

Syntax

HRESULT AssociateContext(
    HWND hWnd,
    HIMC hIME,
    HIMC *phPrev);

Parameters

hWnd

[in] Handle to the window to be associated with the input context.

hIME

[in] Handle to the input context. If hIME is NULL, the method removed any association the window may have had with an input context.

phPrev

[out] Address of the handle to the input context previously associated with the window.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

This method maps to the ImmAssociateContext function documented in the Microsoft® Platform Software Development Kit (SDK). 

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