__crtLCMapStringW
Esegue il mapping di una stringa di caratteri a un'altra, eseguendo una trasformazione specificata dipendente dalle impostazioni locali. Questa funzione può essere anche utilizzata per generare una chiave di ordinamento per la stringa di input.
Sintassi
int __crtLCMapStringW(
LCID Locale,
DWORD dwMapFlags,
LPCWSTR lpSrcStr,
int cchSrc,
LPWSTR lpDestStr,
int cchDest)
Parametri
Locale
Identificatore delle impostazioni locali. Le impostazioni locali forniscono un contesto per il mapping di stringhe o la generazione di chiavi di ordinamento. Un'applicazione può utilizzare la macro MAKELCID
per creare un identificatore delle impostazioni locali.
dwMapFlags
Il tipo di trasformazione da utilizzare durante il mapping di stringhe o la generazione di chiavi di ordinamento.
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. Si presuppone che questo parametro sia una stringa Unicode.
cchSrc
Dimensione, in caratteri, della stringa puntata dal parametro lpSrcStr
. Questo conteggio può includere o meno la terminazione NULL.
Un valore cchSrc
pari a -1 specifica che la stringa puntata da lpSrcStr
ha terminazione Null. In tal caso, e questa funzione viene usata nella modalità di mapping delle stringhe, la funzione calcola la lunghezza della stringa stessa e null termina la stringa mappata archiviata in *lpDestStr
.
lpDestStr
Puntatore long a un buffer in cui la funzione archivia la stringa mappata o la chiave di ordinamento.
cchDest
Dimensione, in caratteri, del buffer puntato da lpDestStr
.
Valore restituito
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. Questo conteggio include lo spazio per una terminazione NULL.
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. Questa dimensione include lo spazio per una terminazione NULL.
Zero indica un errore. Per ottenere informazioni estese sull'errore, chiamare la funzione GetLastError
.
Osservazioni:
Se cchSrc
è maggiore di zero e lpSrcStr
è una stringa con terminazione null, __crtLCMapStringW
imposta cchSrc
sulla lunghezza della stringa. Quindi __crtLCMapStringW
chiama la versione di stringa a caratteri wide (Unicode) della funzione LCMapString
con i parametri specificati. Per altre informazioni sui parametri e sul valore restituito di questa funzione, vedere .LCMapString
Requisiti
Ciclo | Intestazione obbligatoria |
---|---|
__crtLCMapStringW |
<awint.h> |