IActiveIMMApp::GetImeMenuItemsA Method

---

Retrieves the menu items that are registered in the IME menu. ANSI implementation.

Syntax

HRESULT GetImeMenuItemsA(
    HIMC hIMC,
    DWORD dwFlags,
    DWORD dwType,
    IMEMENUITEMINFOA *pImeParentMenu,
    IMEMENUITEMINFOA *pImeMenu,
    DWORD dwSize,
    DWORD *pdwResult
);

Parameters

hIMC

[in] Handle to the input context.

dwFlags

[in] Unsigned long integer value that contains the menu information flags.

dwType

[in] Unsigned long integer value that contains the type of menu returned by this method.

pImeParentMenu

[in] Address of an IMEMENUITEMINFOA structure that has the fType member set to MFT_SUBMENU to return information about the submenu items of this parent menu. If this parameter is NULL, the function returns only top-level menu items.

pImeMenu

[out] Address of an array of IMEMENUITEMINFOA structures to receive the contents of the menu items.

dwSize

[in] Unsigned long integer value that contains the size of the buffer to receive the structures.

pdwResult

[out] Address of an unsigned long integer value that receives the number of menu items copied into pImeMenu. If pImeMenu is null, the function returns the number of registered menu items.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

This method is only available for Microsoft® Windows® 98 and Windows NT® 4.0. This method maps to the ImmGetImeMenuItems function documented in the Microsoft Platform Software Development Kit (SDK).