Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

__crtLCMapStringW

 

Veröffentlicht: März 2016

Bildet eine Zeichenfolge in eine andere ab und führt die angegebene gebietsschemaabhängige Transformation ausführt. Mit dieser Funktion kann auch ein Sortierschlüssel für die Eingabezeichenfolge generiert werden.

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

Locale

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 die Quellzeichenfolge, die die Funktion abbildet oder für die Generierung des Sortierschlüssels nutzt. 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. Diese Anzahl kann den NULL-Terminator enthalten, muss jedoch 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 lässt die zugeordnete Zeichenfolge, die in *lpDestStr gespeichert wird, auf Null enden.

lpDestStr

Langer Zeiger auf einen Puffer, in dem die Funktion die zugeordnete Zeichenfolge oder den Sortierschlüssel speichert.

cchDest

Größe, in Zeichen, des Puffers, auf die von lpDestStr verwiesen wird.

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. Diese Anzahl 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.

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 Rückgabewerten dieser Funktion finden Sie unter der LCMapString-Funktion der MSDN Library.

Anforderungen

Routine

Erforderlicher Header

__crtLCMapStringW

awint.h

Anzeigen: