__crtLCMapStringW__crtLCMapStringW

Esegue il mapping di una stringa di caratteri a un'altra, eseguendo una trasformazione specificata dipendente dalle impostazioni locali.Maps one character string to another, performing a specified locale-dependent transformation. Questa funzione può essere anche utilizzata per generare una chiave di ordinamento per la stringa di input.This function can also be used to generate a sort key for the input string.

SintassiSyntax

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

ParametriParameters

Locale
Identificatore delle impostazioni locali.Locale identifier. Le impostazioni locali forniscono un contesto per il mapping di stringhe o la generazione di chiavi di ordinamento.The locale provides a context for the string mapping or sort key generation. Un'applicazione può utilizzare la macro MAKELCID per creare un identificatore delle impostazioni locali.An application can use the MAKELCID macro to create a locale identifier.

dwMapFlags
Il tipo di trasformazione da utilizzare durante il mapping di stringhe o la generazione di chiavi di ordinamento.The type of transformation to be used during string mapping or sort key generation.

lpSrcStr
Puntatore a una stringa di origine di cui la funzione esegue il mapping o che la funzione utilizza per la generazione di chiavi di ordinamento.Pointer to a source string that the function maps or uses for sort key generation. Si presuppone che questo parametro sia una stringa Unicode.This parameter is assumed to be a Unicode string.

cchSrc
Dimensione, in caratteri, della stringa puntata dal parametro lpSrcStr .Size, in characters, of the string pointed to by the lpSrcStr parameter. Questo conteggio può includere o meno la terminazione NULL.This count can include the NULL terminator, or not include it.

Un valore cchSrc pari a -1 specifica che la stringa puntata da lpSrcStr ha terminazione Null.A cchSrc value of -1 specifies that the string pointed to by lpSrcStr is null-terminated. In tal caso e se questa funzione viene utilizzata nella modalità di mapping di stringhe, la funzione calcola la lunghezza della stringa e fa terminare con null la stringa mappata archiviata in *lpDestStr.If this is the case, and this function is being used in its string-mapping mode, the function calculates the string's length itself, and null-terminates the mapped string stored into *lpDestStr.

lpDestStr
Puntatore long a un buffer in cui la funzione archivia la stringa mappata o la chiave di ordinamento.Long pointer to a buffer into which the function stores the mapped string or sort key.

cchDest
Dimensione, in caratteri, del buffer puntato da lpDestStr.Size, in characters, of the buffer pointed to by lpDestStr.

Valore restituitoReturn Value

Se il valore di cchDest è diverso da zero, il numero di caratteri, o di byte se LCMAP_SORTKEY viene specificato, scritto nel buffer indica l'esito positivo.If the value of cchDest is nonzero, the number of characters, or bytes if LCMAP_SORTKEY is specified, written to the buffer indicates success. Questo conteggio include lo spazio per una terminazione NULL.This count includes room for a NULL terminator.

Se il valore di cchDest è zero, la dimensione del buffer in caratteri, o byte se LCMAP_SORTKEY viene specificato, richiesta per ricevere la stringa tradotta o la chiave di ordinamento indica l'esito positivo.If the value of cchDest is zero, the size of the buffer in characters, or bytes if LCMAP_SORTKEY is specified, required to receive the translated string or sort key indicates success. Questa dimensione include lo spazio per una terminazione NULL.This size includes room for a NULL terminator.

Zero indica un errore.Zero indicates failure. Per ottenere informazioni estese sull'errore, chiamare la funzione GetLastError .To get extended error information, call the GetLastError function.

NoteRemarks

Se cchSrc è maggiore di zero e lpSrcStr è una stringa con terminazione null, __crtLCMapStringW imposta cchSrc sulla lunghezza della stringa.If cchSrc is greater than zero and lpSrcStr is a null-terminated string, __crtLCMapStringW sets cchSrc to the length of the string. Quindi __crtLCMapStringW chiama la versione di stringa a caratteri wide (Unicode) della funzione LCMapString con i parametri specificati.Then __crtLCMapStringW calls the wide string (Unicode) version of the LCMapString function with the specified parameters. Per altre informazioni sui parametri e sul valore restituito di questa funzione, vedere la funzione LCMapString in MSDN Library.For more information about the parameters and return value of this function, see the LCMapString function at MSDN Library.

RequisitiRequirements

RoutineRoutine Intestazione obbligatoriaRequired header
__crtLCMapStringW__crtLCMapStringW awint.hawint.h