__crtLCMapStringW
Mappage une chaîne de caractères à un autre, l'exécution d'une transformation dépendante des paramètres régionaux spécifiée.cette fonction peut également être utilisée pour générer une clé de tri pour la chaîne d'entrée.
int __crtLCMapStringW(
LCID Locale,
DWORD dwMapFlags,
LPCWSTR lpSrcStr,
int cchSrc,
LPWSTR lpDestStr,
int cchDest)
Paramètres
Locale
identificateur de paramètres régionaux.Les paramètres régionaux fournissent un contexte pour le mappage de la chaîne ou la génération de clé de tri.Une application peut utiliser la macro d' MAKELCID pour créer un identificateur de paramètres régionaux.dwMapFlags
Le type de transformation à utiliser pendant le mappage de la chaîne ou la génération de clé de tri.lpSrcStr
Pointeur vers une chaîne source que la fonction mappe ou utilise pour la génération de clé de tri.Il est supposé que ce paramètre est une chaîne Unicode.cchSrc
Taille, en caractères, de la chaîne désignée par le paramètre d' lpSrcStr .Ce compteur peut inclure la marque de fin null, ou ne pas inclure la.Une valeur d' cchSrc de - 1 spécifie que la chaîne désignée par lpSrcStr se terminant par null.Si tel est le cas, et cette fonction est utilisée dans son mode de chaîne-mappage, la fonction calcule la longueur de la chaîne elle-même, et NULL-termine la chaîne mappée stockée dans *lpDestStr.
lpDestStr
Long pointeur vers une mémoire tampon dans laquelle la fonction signale la chaîne ou la clé de tri mappée.cchDest
Taille, en caractères, de la mémoire tampon désignée par lpDestStr.
Valeur de retour
Si la valeur d' cchDest est différente de zéro, le nombre de caractères, ou les octets si LCMAP_SORTKEY est spécifié, écrits dans la mémoire tampon indique succès.Ce compteur inclut la place pour une marque de fin null.
Si la valeur d' cchDest est zéro, la taille de la mémoire tampon de caractères, ou les octets si LCMAP_SORTKEY est spécifié, obligatoire pour accepter la chaîne ou la clé de tri traduite indique succès.Cette taille inclut la place pour une marque de fin null.
Zéro indique cette défaillance.Pour obtenir les informations d'erreurs étendues, appelez la fonction d' GetLastError .
Notes
Si cchSrc est supérieur à zéro et lpSrcStr est une chaîne terminée par le caractère NULL, __crtLCMapStringW définit cchSrc à la longueur de la chaîne.Ensuite __crtLCMapStringW appelle la version pointeur de chaîne (Unicode) de la fonction d' LCMapString avec les paramètres spécifiés.Pour plus d'informations sur les paramètres et la valeur de retour de cette fonction, consultez la fonction d' LCMapString à l'adresse MSDN Library.
Configuration requise
routine |
en-tête requis |
---|---|
__crtLCMapStringW |
awint.h |