MultiByteToWideChar函数说明

1、函数定义
int MultiByteToWideChar(UINT CodePage, DWORD dwFlags, LPCSTR lpMultiByteStr, int cchMultiByte, LPWSTR lpWideCharStr, int cchWideChar
);
2、参数说明
（1）、CodePage
CodePage指定执行转换的字符集，可在以下选择：
CP_ACP： ANSI字符集；
CP_MACCP： Macintosh代码页；
CP_OEMCP： OEM代码页；
CP_SYMBOL： 符号字符集（42）；
CP_THREAD_ACP： 当前线程ANSI代码页；
CP_UTF7： 使用UTF-7转换；
CP_UTF8： 使用UTF-8转换。
（2）、dwFlags
dwFlags是一组未标记，用以指出是否未转换成预定字符，是否使用象形文字替代控制字符，以及如何处理无效字符。可以指定标记常量的组合，标记常量定义如下：
MB_PRECOMPOSED：通常使用预作字符，由一个基本字符和一个非空字符组成的字符只有一个单一的字符值。这是缺省的转换选择。不能与MB_COMPOSITE值一起使用。
MB_COMPOSITE：通常使用组合字符，由一个基本字符和一个非空字符组成的字符分别有不同的字符值。不能与MB_PRECOMPOSED值一起使用。
MB_ERR_INVALID_CHARS：如果函数遇到无效的输入字符，它将运行失败，且GetLastErro返回ERROR_NO_UNICODE_TRANSLATION值。
MB_USEGLYPHCHARS：使用象形文字替代控制字符。
（3）、lpMultiByteStr
lpMultiByteStr指向将被转换字符串的字符。
（4）、cchMultiByte
cchMultiByte指定由参数lpMultiByteStr指向的字符串中字节的个数。如果lpMultiByteStr指定的字符串以空字符终止，可以设置为-1（如果字符串不是以空字符中止，设置为-1可能失败，可能成功），此参数设置为0函数将失败。
（5）、lpWideCharStr
lpWideCharStr指向接收被转换字符串的缓冲区。
（6）、cchWideChar
cchWideChar指定由参数lpWideCharStr指向的缓冲区的宽字符个数。若此值为零，函数返回缓冲区所必需的宽字符数，在这种情况下lpWideCharStr中的缓冲区不被使用。
3、返回值
如果函数运行成功，并且cchWideChar不为零，返回值是由lpWideCharStr指向的缓冲区中写入的宽字符数；如果函数运行成功，并且cchWideChar为零，返回值是接收到待转换字符串的缓冲区所需求的宽字符数大小。如果函数运行失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。它可以返回下面所列错误代码：
ERROR_INSUFFICIENT_BUFFER；ERROR_INVALID_FLAGS；
ERROR_INVALID_PARAMETER；ERROR_NO_UNICODE_TRANSLATION。
4、应用
该函数用于ASNI、UNICODE、及UTF-8之间的转换。