MultiByteToWideChar

MultiByteToWideChar

　　4.31.28 MultiByteToWideChar
　　函数功能：该函数映射一个字符串到一个宽字符（unicode）的字符串。由该函数映射的字符 串没必要是多字节字符组。
　　函数原型：int MultiByteToWideChar(UINT CodePage, DWORD dwFlags, LPCSTR lpMultiByteStr, int cchMultiByte, LPWSTR lpWideCharStr, int cchWideChar);
　　参数：
　　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转换。
　　dwFlags：一组位标记用以指出是否未转换成预作或宽字符（若组合形式存在），是否使用象 形文字替代控制字符，以及如何处理无效字符。你可以指定下面是标记常量的组合，含义如下：
　　MB_PRECOMPOSED：通常使用预作字符——就是说，由一个基本字符和一个非空字符组 成的字符只有一个单一的字符值。这是缺省的转换选择。不能与
　　MB_COMPOSITE值一起使用。
　　MB_COMPOSITE：通常使用组合字符——就是说，由一个基本字符和一个非空字符组成的 字符分别有不同的字符值。不能与MB_PRECOMPOSED值一起使用。
　　MB_ERR_INVALID_CHARS：如果函数遇到无效的输入字符，它将运行失败，且 GetLastErro返回ERROR_NO_UNICODE_TRANSLATION值。
　　MB_USEGLYPHCHARS：使用象形文字替代控制字符。
　　组合字符由一个基础字符和一个非空字符构成，每一个都有不同的字符值。每个预作字符都有单一的 字符值给基础/非空字符的组成。在字符è中，e就是基础字符，而重音符标记就是非空字符。
　　函数的缺省动作是转换成预作的形式。如果预作的形式不存在，函数将尝试转换成组合形式。
　　标记MB_PRECOMPOSED和MB_COMPOSITE是互斥的，而标记 MB_USEGLYPHCHARS和MB_ERR_INVALID_CHARS则不管其它标记如何都可以设置。
　　lpMultiByteStr：指向将被转换字符串的字符。
　　cchMultiByte：指定由参数lpMultiByteStr指向的字符串中字节的个 数。如果这个值为-1，字符串将被设定为以NULL为结束符的字符串，并且自动计算长度。
　　lpWideCharStr：指向接收被转换字符串的缓冲区。
　　cchWideChar：指定由参数lpWideCharStr指向的缓冲区的字节个数。若此 值为零，函数返回缓冲区所必需的宽字符数，在这种情况下，lpWideCharStr中的缓冲区不被使用。
　　返回值：如果函数运行成功，并且cchWideChar不为零，返回值是由 lpWideCharStr指向的缓冲区中写入的宽字符数；如果函数运行成功，并且cchMultiByte为零，返回值是接收到待转换字符串的缓冲区所 需求的宽字符数大小。如果函数运行失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。它可以返回下面所列错误代码：
　　 ERROR_INSUFFICIENT_BJFFER；ERROR_INVALID_FLAGS；
　　 ERROR_INVALID_PARAMETER；ERROR_NO_UNICODE_TRANSLATION。
　　注意：指针lpMultiByteStr和lpWideCharStr必须不一样。如果一样， 函数将失败，GetLastError将返回ERROR_INVALID_PARAMETER的值。
　　如果MB_ERR_INVALID_CHARS被设置并且在资源字符串中遇到无效的字符时，函 数将失败。如果MB_ERR_INVALID_CHARS不被设置，或是DBCS串中发现了头字节而没有有效的尾字节，无效字符将转换为缺省字符，但不是 资源字符串中的缺省字符。当无效字符被发现，且MB_ERR_INVALID_CHARS值被设置，函数返回零，GetLastErro显示 ERROR_NO_UNICODE_TRANSLATION的出错信息。
　　Windows CE：不支持参数CodePage中的CP_UTF7和CP_UTF8的值，以及参数dwFlags中的WC_NO_BEST_FIT_CHARS值。
　　速查：Windows NT 3.1、Windows 95以上、Windows CE 1.0以上，头文件：winnls.h；库文件：kernel32.lib。

转载于:https://www.cnblogs.com/powerkoria/archive/2010/03/23/1692290.html