MultiByteToWideChar[多字节转宽字符]详解

1、MultiByteToWideChar函数功能：该函数映射一个字符串到一个宽字符(unicode )的字符串。由该函数映射的字符串没必要是多字节字符组。(此函数把多字节字符串转换成宽字符串(Unicode),待转换的字符串并不一定是多字节的。)函数原型：int MultiByteToWideChar(UINT CodePage,DWORD dwFlags,LPCSTR lpMultiByteStr,int cchMultiByte,LPWSTR lpWideCharStr,int cchWideChar);补充：如果ANSI代码页允许在不同的计算机上不相同，甚至在单台计算机上不一 样，将会导致

2、数据崩溃。为了代码页一致性，应用程序应该使用Unicode编码，如UTF-8或者UTF-1G而不是使用特殊的代码页，除了早期标准或者数据 格式化不允许使用Unicode编码。在特殊情况下，有些函数不允许使用Unicode编码，应用程序应在协议充许的情况下在数据流中用合适的编码名称标识。在 HTML、XML、HTTP等文件中都允许标识，但 TEXT本不允许这样做。参数：CodePage指定执行转换的代码页，这个参数可以为系统已安装或有效的 任何代码页所给定的值。你也可以指定其为下面的任意一值：(我想最常用的应该是CP_AC环口 CP_UTF8T,前者将宽字符转换为ANSI后者转换为UTF8。 )

3、CP_ACPCP_MACCPCP_OEMCPCP_SYMBOLCP_THREAD_ACPCP_UTF7CP_UTF8AN班码页Macintosh 代码页OEM 代码页符号代码页(42)当前线索ANSI代码页使用UTF-7转使用UTF-8转换dwFlags：指定是否转换成预制字符或合成的宽字符，对控制字符是否使用像形文字，以及怎样处理无效字符。总是使用预制字符，即有单个预制字符时，就不会使用分解的基MB_PRECOMPOSED符和不占空间字符。此为函数的默认选项，不能和MB_COMPOSIT合用MB_COMPOSITEMB_ERR_INVALID_CHA嗡是使用分解字符，即总是使用基字符 +不占

4、空间 字符的方式设置此选项，函数遇到非法字符就失败并返回错误码ERROR_NO_UNICODE_TRANSLA ION贝U丢弃非法字符MB_USEGLYPHCHARS用像形字符代替控制字符注意：组合字符由一个基础字符和一个非空字符构成，每一个都有不同的字符值。每个预作字符都有单一的字符值给基础/非空字符的组成。在字符3中，e 就是基础字符，而重音符标记就是非空字符。函数的缺省动作是转换成预作的形式。如果预作的形式不存在，函数将尝试转换成组合形式。标记 MB_PRECOMPOSED MB_COMPOSITE!:互斥的，而标记 MB_USEGLYPHCHAR SMB_ERR_INVALID_CHA

5、RS 不管其它标记如何者 B 可以设 置。对于下列代码页，dwFlags必须为0,否则函数返回错误码 ERROR_INVALID_FLA GS50220 50221 50222 50225 50227 50229 52936 54936 57002到 5701165000(UTF7) 42(Symbo附于 UTFa dwFlags必须为 0 或 MB_ERR_INVALID_CHAR瓯则函数都将失败并返回错误码 ERROR_INVALID_FLA GSlpMultiByteStr：指向将被转换字符串的字符。cchMultiByte ：指定由参数lpMultiByteStr 指向的字符串中字节的

6、个数。如果lpMultiByteStr 指定的字符串以空字符终止，可以设置为-1(如果字符串不是以空字符中止，设置为 -1 可能失败，可能成功)，此参数设置为 0 函数将失败。IpWideCharStr：指向接收被转换字符串的缓冲区。cchWideChar：指定由参数IpWideCharStr指向的缓冲区的字符个数。若此值为零，函数返 回缓冲区所必需的宽字符数，在这种情况下，lpWideCharStr 中的缓冲区不被使用。返回值如果函数运行成功，并且 cchWideChar不为零，返回值是由IpWideCharStr 指向的缓冲区中写入的宽字符数；如果函数运行成功，并且cchMultiByte

7、 为零，返回值是接收到待转换字符串的缓冲区所需求的宽字符数大小。如果函数 运行失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。它可以返回下面所列错误代码：ERROR_INSUFFICIENT_BUF；FEERRROR_INVALID_FLA；GS ERROR_INVALID_PARAMET EERROR_NO_UNICODE_TRANSLAT ION注意指针lpMultiByteStr和lpWideCharStr必须不一样。如果一样，函数将失 败，GetLastError将返回 ERROR_INVALID_PARAMETERt。如果 mb_err_invalid_chaRS设置并且在资源字符串中遇到无效的字符时，函数将 失败。如果MB_ERR_INVALID_CHARS被设置，或是DBC坤中发现了头字节而 没有有效的尾字节，无效字符将转换为缺省字符，但不是资源字符串中的缺省 字符。当无效字符被发现，且 MB_ERR_INVALID_CHARS被设置，函数返回 零，GetLastErro显示 ERROR_NO_UNICODE_TRANSLATION错信息。Windows CE：不支持参数CodePage中的CP_UTF7f口 CP_UTF8