C# Signature:

[DllImport("Imm32.dll", SetLastError=true)]
public static extern int ImmGetConversionList(
    IntPtr hKL,
    IntPtr hIMC,
    string lpSrc,
    IntPtr lpDst,
    int dwBufLen,
    int uFlag
    );

VB Signature:

Declare Function ImmGetConversionList Lib "Imm32.dll" (TODO) As TODO

User-Defined Types:

None.

Notes:

written by K.Morono on DEC 6 2004

Tips & Tricks:

Please add some!

Sample Code:

const int GCL_REVERSECONVERSION = 0x0002;
[StructLayout(LayoutKind.Sequential)]
public class CANDIDATELIST
{
    public int  dwSize;
    public int  dwStyle;
    public int  dwCount;
    public int  dwSelection;
    public int  dwPageStart;
    public int  dwPageSize;
    public int  dwOffset;
}

public string[] GetReverseConversion(string AText)
{
    string[] strList = null;
    IntPtr hIMC = ImmGetContext(this.Handle);
    IntPtr hKL = GetKeyboardLayout(0);
    if ((hIMC != IntPtr.Zero)&&(hKL != IntPtr.Zero))
    {
        CANDIDATELIST list = new CANDIDATELIST();
        int dwSize = ImmGetConversionList(hKL,hIMC,AText,IntPtr.Zero,0,GCL_REVERSECONVERSION);
        if (dwSize>0)
        {
            IntPtr BufList = Marshal.AllocHGlobal(dwSize);
            ImmGetConversionList(hKL,hIMC,AText,BufList,dwSize,GCL_REVERSECONVERSION);
            Marshal.PtrToStructure(BufList,list);
            byte[] buf = new byte[dwSize];
            Marshal.Copy(BufList,buf,0,dwSize);
            Marshal.FreeHGlobal(BufList);
            int os = list.dwOffset;
            string str = System.Text.Encoding.Default.GetString(buf,os,buf.Length-os);
            str = Regex.Replace(str,@"\0+$","");
            char[] par = "\0".ToCharArray();
            string[] temp = str.Split(par);
            strList = new string[list.dwCount];
            Array.Copy(temp,0,strList,0,list.dwCount);
            ImmReleaseContext(this.Handle,hIMC);
        }
    }
    return strList;
}

Alternative Managed API:

Do you know one? Please contribute it!

Please edit this page!

Do you have...

• helpful tips or sample code to share for using this API in managed code?
• corrections to the existing content?
• variations of the signature you want to share?
• additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).