__crtLCMapStringW

Asigna una cadena de caracteres a otra, para lo que realiza una transformación de dependiente de la configuración regional especificada. Esta función también puede usarse para generar un criterio de ordenación para la cadena de entrada.

Sintaxis

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

Parámetros

Locale
El identificador de configuración regional. La configuración regional proporciona un contexto para la asignación de la cadena o la generación del criterio de ordenación. Una aplicación puede usar la macro MAKELCID para crear un identificador de configuración regional.

dwMapFlags
Tipo de transformación que se usará durante la asignación de la cadena o la generación del criterio de ordenación.

lpSrcStr
Puntero a una cadena de origen que la función asigna o usa para la generación del criterio de ordenación. Se supone que este parámetro es una cadena Unicode.

cchSrc
Tamaño, en caracteres, de la cadena a la que apunta el parámetro lpSrcStr . Este recuento puede incluir el terminador NULL o no.

Un valor cchSrc de -1 especifica que la cadena a la que apunta lpSrcStr termina en NULL. Si es así, y esta función se usa en su modo de asignación de cadenas, la función calcula la propia longitud de la cadena y null finaliza la cadena asignada almacenada en *lpDestStr.

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

cchDest
Tamaño, en caracteres, del búfer al que apunta lpDestStr.

Valor devuelto

Si el valor de cchDest es distinto de cero, el número de caracteres (o bytes, si se especifica LCMAP_SORTKEY ) escrito en el búfer indica que la operación ha sido correcta. Este recuento incluye espacio para un terminador NULL.

Si el valor de cchDest es cero, el tamaño del búfer en caracteres (o bytes, si se especifica LCMAP_SORTKEY ) necesario para recibir la cadena traducida o el criterio de ordenación indica que la operación ha sido correcta. Este tamaño incluye espacio para un terminador NULL.

Cero indica un error. Para obtener información de errores extendida, realice una llamada a la función GetLastError .

Comentarios

Si cchSrc es mayor que cero y lpSrcStr es una cadena terminada en NULL, __crtLCMapStringW establece cchSrc en la longitud de la cadena. Después, __crtLCMapStringW llama a la versión de cadena de caracteres anchos (Unicode) de la función 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 .LCMapString

Requisitos

Routine	Encabezado necesario
__crtLCMapStringW	<awint.h>