__crtLCMapStringW

Сопоставления " одна символьная строка, выполняя указанное преобразование, зависимых от языковых стандартов.Эта функция может также использоваться при формировании ключа сортировки входной строки.

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

Параметры

• Locale
  Код языка.Языковой стандарт предоставляет контекст для формирования сопоставления строк или ключей сортировки.Приложение может использовать MAKELCID макрос для создания кода языка.

• dwMapFlags
  Тип преобразования, используемый при создании сопоставления строк или ключей сортировки.

• lpSrcStr
  Указатель на строку, которая сопоставляет или источника функция используется для формирования ключа сортировки.Предполагается, что этот параметр строкой Юникода.

• cchSrc
  Размер (в символах), строки указал значение lpSrcStr параметр.Этот счетчик может включать символ конца строки null или не включать их.

  A cchSrc значение 1 указывает на то, что строка указала к которым следуют lpSrcStr null-завершит.Если это так, и эта функция используется в своем режиме строка-сопоставления, то функция вычисляет размер самой строки, а null-завершит сопоставленная строка, хранящиеся в *lpDestStr.

• lpDestStr
  Длинный указатель на буфер, в который функция хранит сопоставленные строка или ключ сортировки.

• cchDest
  Размер буфера (в символах), указал к которым следуют lpDestStr.

Возвращаемое значение

Если значение cchDest не равны нулю, числ символов или байт, если LCMAP_SORTKEY указывает, записывается в буфер означает успешное выполнение процедуры.Этот счетчик включает места для признака конца NULL.

Если значение cchDest ноль, размер из буфера (в символах) или если байты LCMAP_SORTKEY определяет, необходим для получения переведенную строку или ключ сортировки означает успешное выполнение процедуры.Этот размер включает в себя места для признака конца NULL.

Нулевое значение указывает на сбой.Чтобы получить расширенные сведения об ошибке, вызовите GetLastError функция.

Заметки

If cchSrc больше нуля и lpSrcStr строка, null-завершенная __crtLCMapStringW наборы cchSrc на длину строки.Then __crtLCMapStringW вызывает широкая версия строки (юникод) LCMapString функции с заданными параметрами.Дополнительные сведения о параметрах и возвращаемого значения этой функции см. в разделе LCMapString функции для библиотека MSDN.

Требования