__crtLCMapStringW

映射到字符字符串到另一个，执行一个指定的区域设置相关的转换。 此函数还可用于生成输入一个字符串的排序关键字。

int __crtLCMapStringW(
   LCID    Locale,
   DWORD   dwMapFlags,
   LPCWSTR lpSrcStr,
   int     cchSrc,
   LPWSTR  lpDestStr,
   int     cchDest)

参数

• Locale
  区域设置标识符。 区域设置为映射中的字符串提供一个上下文或排序关键字生成。 应用程序可以使用 MAKELCID 宏创建区域设置标识符。

• dwMapFlags
  在字符串的过程中使用的强制转换的类型映射或排序关键字生成。

• lpSrcStr
  传递给函数映射或使用的源字符串的指针排序关键字生成。 此参数假定为 Unicode 字符串。

• cchSrc
  调整大小，在字符，该字符串指向由 lpSrcStr 参数。 此计数可能包含 NULL 结束符或不包括它。

  cchSrc 值 – 1 指定字符串指向由 lpSrcStr null 结尾。 如果是这样，因此，此函数使用该字符串映射的模式，函数计算字符串的长度，并以 null 结尾将映射的字符串存储到 *lpDestStr。

• lpDestStr
  传递给函数存储该映射的字符串缓冲区的长指针或排序关键字。

• cchDest
  调整大小，在字符，缓冲区指向由 lpDestStr。

返回值

如果 cchDest 的值不为零，字符数或字节，如果 LCMAP_SORTKEY 指定，将写入缓冲区指示成功。 此计数包括 null 结束符的空格。

如果 cchDest 的值为零、缓冲区的大小 (以字符的或字节，如果 LCMAP_SORTKEY 指定，需要接收该转换的字符串或排序关键字指示成功。 此范围包含 null 结束符的空格。

零指示失败。 若要扩展的错误信息，调用 GetLastError 功能。

备注

如果 cchSrc 大于零和 lpSrcStr 一个 null 终止的字符串大， __crtLCMapStringW 设置 cchSrc 设置为字符串的长度。 然后 __crtLCMapStringW 调用 LCMapString 功能的宽字符 (unicode) 版本与指定参数的。 有关参数的更多信息和返回此函数的值，请参见 LCMapString 函数在 MSDN Library。

要求

实例	必需的头
__crtLCMapStringW	awint.h