WideCharToMultiByte

WideCharToMultiByte 是一个 Windows API 函数，用于将 Unicode 字符串转换为多字节字符串。该函数的原型为：

int WideCharToMultiByte(
  UINT     CodePage,         // 要使用的代码页
  DWORD    dwFlags,          // 标志，指定如何进行转换
  LPCWCH   lpWideCharStr,    // Unicode 字符串的地址
  int      cchWideChar,      // Unicode 字符串的长度（以字符数为单位）
  LPSTR    lpMultiByteStr,   // 缓冲区，用于存储转换后的多字节字符串
  int      cbMultiByte,      // 缓冲区的大小（以字节为单位）
  LPCCH    lpDefaultChar,    // 指向用于替换无法转换的 Unicode 字符的默认字符
  LPBOOL   lpUsedDefaultChar // 指向一个变量，用于指示是否使用了默认字符
);

参数说明：

- CodePage：要使用的代码页。常见的代码页有 GB2312、GBK、UTF-8 等。
- dwFlags：标志，指定如何进行转换。常见的标志有 WC_COMPOSITECHECK、WC_DEFAULTCHAR、WC_ERR_INVALID_CHARS 等。
- lpWideCharStr：Unicode 字符串的地址。
- cchWideChar：Unicode 字符串的长度，以字符数为单位。
- lpMultiByteStr：缓冲区，用于存储转换后的多字节字符串。
- cbMultiByte：缓冲区的大小，以字节为单位。
- lpDefaultChar：指向用于替换无法转换的 Unicode 字符的默认字符。
- lpUsedDefaultChar：指向一个变量，用于指示是否使用了默认字符。

调用 WideCharToMultiByte 函数成功后，会返回转换后的多字节字符串的长度。如果转换失败，会返回 0。