__crtLCMapStringW

Mapuje jeden řetězec znaků jiným provedením Zadaná transformace závislé na nastavení národního prostředí.Tuto funkci lze také generovat klíč řazení pro vstupní řetězec.

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

Parametry

• Locale
  Identifikátor národního prostředí.Národní prostředí poskytuje kontext pro mapování řetězců nebo generování klíčů řazení.Můžete použít aplikaci MAKELCID makro vytvořit identifikátor národního prostředí.

• dwMapFlags
  Typ transformace, která bude použita při řetězec mapování nebo řazení generování klíče.

• lpSrcStr
  Ukazatel na zdrojový řetězec, který funkci mapy nebo používá pro generování klíčů řazení.Tento parametr je přiřazena hodnota řetězec Unicode.

• cchSrc
  Velikost znaků řetězce odkazuje lpSrcStr parametr.Tento počet lze zahrnout ukončovací znak NULL nebo nesmí obsahovat.

  A cchSrc hodnotu –1 určuje, že řetězce odkazuje lpSrcStr je zakončený hodnotou null.Je-li v tomto případě je tato funkce použita v režimu mapování řetězců, vypočítá řetězec délky sám funkce a null ukončí mapované řetězec uložen do *lpDestStr.

• lpDestStr
  Dlouhé ukazatel do vyrovnávací paměti, do které uloží funkce mapované klíč řetězce nebo řazení.

• cchDest
  Velikost znaků vyrovnávací paměti odkazuje lpDestStr.

Vrácená hodnota

Pokud hodnota cchDest je nenulová, počet znaků nebo bajtů Pokud LCMAP_SORTKEY je určena, zapsány do vyrovnávací paměti označuje úspěch.Tento počet zahrnuje místnosti pro ukončovací znak NULL.

Pokud hodnota cchDest je nula, velikost vyrovnávací paměti v znaků nebo bajtů, pokud LCMAP_SORTKEY je určen, povinen přijmout přeložená řetězec nebo řazení klíč označuje úspěch.Tato velikost zahrnuje místnosti pro ukončovací znak NULL.

Nula označuje chybu.Chcete-li získat rozšířené informace o chybě, volání GetLastError funkce.

Poznámky

Pokud cchSrc je větší než nula a lpSrcStr je řetězec zakončený __crtLCMapStringW nastaví cchSrc na délku řetězce.Potom __crtLCMapStringW volá verzi široké řetězec (Unicode) LCMapString funkce se zadaným parametrům.Další informace o parametrech a vrácené hodnoty funkce naleznete LCMapString fungovat, MSDN Library.

Požadavky

Rutina	Požadované záhlaví
__crtLCMapStringW	awint.h