__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>