__crtLCMapStringW

Mapuje jeden ciąg znaków do innego, wykonywanie określonego przemian zależnych od ustawień regionalnych.Ta funkcja umożliwia również wygenerować klucz sortowania dla ciągu wejściowego.

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

Parametry

• Locale
  Identyfikator ustawień regionalnych.Ustawienia regionalne zapewnia kontekst dla mapowania ciągów lub sortowanie generowania kluczy.Aplikacja może korzystać z MAKELCID makro w celu utworzenia identyfikatora ustawień regionalnych.

• dwMapFlags
  Typ transformacji ma być używany podczas ciąg mapowania lub sortowanie generowania kluczy.

• lpSrcStr
  Wskaźnik, aby ciąg źródłowy, że funkcja mapuje lub używane do generowania kluczy sortowania.Przyjęto, że ten parametr może być ciągiem Unicode.

• cchSrc
  Rozmiar w znaki ciągu wskazywanej przez lpSrcStr parametru.Ten licznik może obejmować NULL terminator lub nie.

  A cchSrc wartość –1 określa ciąg wskazywanej przez lpSrcStr jest zakończony znakiem null.Jeśli dotyczy to funkcja ta jest używany w trybie mapowania ciągów, funkcja oblicza długość ciągu, sama i null kończy mapowane ciąg przechowywane w *lpDestStr.

• lpDestStr
  Długie wskaźnik do buforu, do którego funkcja przechowuje mapowane klucz ciąg lub sortowania.

• cchDest
  Rozmiar w znakach bufora wskazywanego przez lpDestStr.

Zwracanie wartości

Jeśli wartość cchDest jest różna od zera, liczba znaków lub bajtów Jeśli LCMAP_SORTKEY jest określony, zapisywane do buforu oznacza sukces.Ten licznik obejmuje miejsca dla końcowych wartości NULL.

Jeśli wartość cchDest jest zero, rozmiar buforu znaków lub liczbę bajtów Jeśli LCMAP_SORTKEY jest określony, wymagane do otrzymania tłumaczone ciąg lub sortowania klucza oznacza sukces.Rozmiar ten obejmuje miejsca dla końcowych wartości NULL.

Wartość zero wskazuje błąd.Pobierz rozszerzone informacje o błędach, należy wywołać GetLastError funkcji.

Uwagi

Jeśli cchSrc jest większa od zera i lpSrcStr jest ciągiem zakończonym znakiem null, __crtLCMapStringW ustawia cchSrc długość ciągu.Następnie __crtLCMapStringW wywołuje wersji szeroki ciąg znaków (Unicode) LCMapString funkcji z określonymi parametrami.Aby uzyskać więcej informacji dotyczących parametrów i wartość zwracana przez tę funkcję, zobacz LCMapString przez MSDN Library.

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
__crtLCMapStringW	awint.h