__crtLCMapStringW

Mapuje jeden ciąg znaków na inny, wykonując określoną transformację zależną od ustawień regionalnych. Ta funkcja może również służyć do generowania klucza sortowania dla ciągu wejściowego.

Składnia

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

Parametry

Locale
Identyfikator ustawień regionalnych. Ustawienia regionalne zapewniają kontekst mapowania ciągów lub generowania klucza sortowania. Aplikacja może użyć makra MAKELCID do utworzenia identyfikatora ustawień regionalnych.

dwMapFlags
Typ przekształcenia, który ma być używany podczas mapowania ciągów lub generowania klucza sortowania.

lpSrcStr
Wskaźnik do ciągu źródłowego mapowania lub użycia funkcji do generowania klucza sortowania. Przyjmuje się, że ten parametr jest ciągiem Unicode.

cchSrc
Rozmiar, w znakach, ciągu wskazywanego lpSrcStr przez parametr . Ta liczba może zawierać terminator o wartości null lub nie zawierać go.

Wartość cchSrc -1 określa, że ciąg wskazywany przez lpSrcStr wartość jest zakończony wartością null. Jeśli tak, a ta funkcja jest używana w trybie mapowania ciągów, funkcja oblicza samą długość ciągu, a wartość null kończy mapowany ciąg przechowywany w pliku *lpDestStr.

lpDestStr
Wskaźnik długi do buforu, w którym funkcja przechowuje zamapowany ciąg lub klucz sortowania.

cchDest
Rozmiar , w znakach buforu wskazywany przez lpDestStr.

Wartość zwracana

Jeśli wartość cchDest jest niezerowa, liczba znaków lub bajtów, jeśli LCMAP_SORTKEY jest określona, zapisana w buforze wskazuje powodzenie. Ta liczba zawiera miejsce dla terminatora o wartości null.

Jeśli wartość ma wartość cchDest zero, rozmiar buforu w znakach lub bajtach, jeśli LCMAP_SORTKEY jest określony, wymagany do otrzymania przetłumaczonego ciągu lub klucza sortowania wskazuje powodzenie. Ten rozmiar obejmuje miejsce dla terminatora o wartości null.

Zero wskazuje błąd. Aby uzyskać rozszerzone informacje o błędzie, wywołaj GetLastError funkcję .

Uwagi

Jeśli cchSrc wartość jest większa niż zero i lpSrcStr jest ciągiem zakończonym wartością null, __crtLCMapStringW ustawia cchSrc wartość na długość ciągu. Następnie __crtLCMapStringW wywołuje wersję LCMapString funkcji wide string (Unicode) z określonymi parametrami. Aby uzyskać więcej informacji na temat parametrów i zwracanej wartości tej funkcji, zobacz LCMapString.

Wymagania

Procedura	Wymagany nagłówek
__crtLCMapStringW	<awint.h>