Partager via


__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