IActiveIME::Configure Method

---

Provides the dialog box that is used to request optional information for an Active IME.

Syntax

HRESULT Configure(
    HKL hKL,
    HWND hWnd,
    DWORD dwMode,
    REGISTERWORDW *pRegisterWord
);

Parameters

hKL

[in] Handle to the keyboard layout of the Active IME.

hWnd

[in] Handle to the parent window.

dwMode

[in] Unsigned long integer value that specifies the flag that indicates the mode of the dialog box.

pRegisterWord

[in] Address of a REGISTERWORDW structure if dwMode is set to IME_CONFIG_REGISTERWORD. Otherwise, pRegisterWord should be ignored.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

This method maps to the ImeConfigure function documented in the Microsoft® Windows® 2000 Driver Development Kit.