__crtLCMapStringW

Ordnet eine Zeichenfolge einer anderen zu, wobei eine angegebene Gebietsschema-abhängige Umwandlung durchgeführt wird. Mit dieser Funktion kann auch ein Sortierschlüssel für die Eingabezeichenfolge generiert werden.

Syntax

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

Parameter

Locale
Der Gebietsschemabezeichner. Das Gebietsschema stellt einen Kontext für die Zeichenfolgenzuordnung oder zum Generieren des Sortierschlüssels bereit. Eine Anwendung kann mithilfe des MAKELCID -Makros einen Gebietsschemabezeichner generieren.

dwMapFlags
Der Typ der Transformation, der während der Zeichenfolgenzuordnung oder des Generierens des Sortierschlüssels verwendet werden soll.

lpSrcStr
Zeiger auf eine Quellzeichenfolge, die die Funktion zuordnet oder für die Sortierschlüsselgenerierung verwendet. Für diesen Parameter wird davon ausgegangen, dass es sich um eine Unicode-Zeichenfolge handelt.

cchSrc
Auf die Größe, in Zeichen, der Zeichenfolge wird mit dem lpSrcStr -Parameter verwiesen. Dieser Parameter kann den NULL-Terminator enthalten oder nicht.

Ein cchSrc-Wert von -1 gibt an, dass die Zeichenfolge, auf die von lpSrcStr verwiesen wird, NULL-terminiert ist. Wenn dies der Fall ist und diese Funktion im Zeichenfolgenzuordnungsmodus verwendet wird, berechnet die Funktion die Länge der Zeichenfolge selbst und beendet die zugeordnete Zeichenfolge, die in *lpDestStr.

lpDestStr
Long-Zeiger auf einen Puffer, in den die Funktion die zugeordnete Zeichenfolge oder den Sortierschlüssel speichert.

cchDest
Größe, in Zeichen, des Puffers, auf die von lpDestStrverwiesen wird.

Rückgabewert

Wenn der Wert von cchDest ungleich NULL ist, zeigt die Anzahl der Zeichen oder Bytes, wenn LCMAP_SORTKEY angegeben ist, die in den Puffer geschrieben wird, Erfolg an. Dieser Parameter bietet Platz für einen NULL-Terminator.

Wenn der Wert von cchDest 0 ist, gibt Größe des Puffers in Zeichen oder Bytes, wenn LCMAP_SORTKEY angegeben ist, Erfolg an, was erforderlich für den Empfang der übersetzten Zeichenfolge oder des Sortierschlüssels ist. Diese Größe bietet Platz für einen NULL-Terminator.

Null weist auf einen Fehler hin. Rufen Sie für erweiterte Fehlerinformationen die GetLastError -Funktion auf.

Hinweise

Wenn cchSrc größer als 0 (null) ist und lpSrcStr ist eine Null-terminierte Zeichenfolge, legt __crtLCMapStringWcchSrc auf die Länge der Zeichenfolge fest. __crtLCMapStringW ruft dann die Breitzeichen-Version (Unicode) der LCMapString -Funktion mit den angegebenen Parametern auf. Weitere Informationen zu den Parametern und dem Rückgabewert dieser Funktion finden Sie unter .LCMapString

Anforderungen

Routine	Erforderlicher Header
__crtLCMapStringW	<awint.h>