__crtLCMapStringW

Asigna una cadena de caracteres a otra, transformándolos dependientes configuración especificada.Esta función se puede utilizar para generar un criterio de ordenación de la cadena de entrada.

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

Parámetros

• Locale
  Id. de configuración regional.la configuración regional proporciona un contexto para la asignación de la cadena o la generación de criterio de ordenación.una aplicación puede utilizar la macro de MAKELCID para crear un Id. de configuración regional.

• dwMapFlags
  El tipo de procesamiento que se va a usar durante la asignación de la cadena o la generación de criterio de ordenación.

• lpSrcStr
  Puntero a una cadena de origen que la función asigna o utiliza para la compilación de criterio de ordenación.Este parámetro se supone que es una cadena Unicode.

• cchSrc
  El tamaño, en caracteres, string al que lpSrcStr el parámetro.Este número puede incluir el terminador NULL, o no se incluya.

  Un valor de cchSrc de – 1 especifica que la cadena indicada por a lpSrcStr terminado en null.Si éste es el caso, y esta función se utiliza en el modo de la cadena-asignación, la función calcula la longitud del propio cadena, y nulo-finaliza la cadena asignada almacenada en *lpDestStr.

• lpDestStr
  Puntero largo a un búfer en el que la función almacena la cadena o el criterio de ordenación asignada.

• cchDest
  El tamaño, en caracteres, del búfer al que lpDestStr.

Valor devuelto

Si el valor de cchDest es distinto de cero, el número de caracteres, o los bytes si se especifica LCMAP_SORTKEY , escritos en el búfer indica correctamente.Este recuento incluye el sitio para un terminador NULL.

Si el valor de cchDest es cero, el tamaño del búfer en caracteres, o los bytes si se especifica LCMAP_SORTKEY , requeridos recibir la cadena o el criterio de ordenación traducida indica correctamente.Este tamaño incluye el sitio para un terminador NULL.

cero indica el error.Para obtener información de error extendida, llame a la función de GetLastError .

Comentarios

Si cchSrc es mayor que cero y lpSrcStr es una cadena terminada en null, __crtLCMapStringW establece cchSrc a la longitud de la cadena.A continuación __crtLCMapStringW llama a la versión elevado de la cadena (Unicode) de la función de LCMapString con los parámetros especificados.Para obtener más información sobre los parámetros y el valor devuelto de esta función, vea la función de LCMapString en MSDN Library.

Requisitos

rutina	Encabezado necesario
__crtLCMapStringW	awint.h