Funzione DownlevelLCIDToLocaleName

Articolo
12/21/2023

Converte un identificatore delle impostazioni locali in un nome delle impostazioni locali.

Nota

Questa funzione viene usata solo dalle applicazioni eseguite nei sistemi operativi pre-Windows Vista. L'uso richiede un pacchetto di download. Le applicazioni eseguite solo in Windows Vista e versioni successive devono chiamare LCIDToLocaleName per recuperare un nome delle impostazioni locali.

Sintassi

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Parametri

Impostazioni locali [in]

Identificatore delle impostazioni locali da tradurre. È possibile utilizzare la macro MAKELCID per creare un identificatore delle impostazioni locali. Questa funzione non supporta impostazioni locali neutre o i valori di identificatore delle impostazioni locali specifici seguenti.

lpName [out]

Puntatore a un buffer in cui questa funzione recupera il nome delle impostazioni locali. La funzione recupera NULL se cchName è impostato su 0.

cchName [in]

Dimensioni, in punti di codice UTF-16, del buffer dei nomi delle impostazioni locali. L'applicazione imposta questo parametro su 0 per restituire le dimensioni necessarie del buffer dei nomi delle impostazioni locali.

dwFlags [in]

Flag che specificano il tipo di nome da recuperare. Il valore predefinito è DOWNLEVEL_LOCALE_NAME.

Valore restituito

Restituisce il conteggio dei punti di codice UTF-16 nel nome delle impostazioni locali, incluso il carattere Null di terminazione, se ha esito positivo. Se la funzione ha esito positivo e il valore di cchName è 0, il valore restituito è la dimensione richiesta, in caratteri (inclusi i caratteri Null), per il buffer dei nomi delle impostazioni locali.

La funzione restituisce 0 se non riesce. Per ottenere informazioni di errore estese, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_INSUFFICIENT_BUFFER. Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL.
ERROR_INVALID_FLAGS. Il valore di dwFlags non è valido.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Osservazioni:

Nota

Questa funzione non supporta impostazioni locali personalizzate.

Il file di intestazione e la DLL necessari fanno parte del download "Microsoft NLS Downlevel Data Mapping APIs", che non è più disponibile dall'Area download Microsoft. Usare le API di globalizzazione dell'ICU in Aggiornamento di Windows 10 (maggio 2019) e versioni successive.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Componente ridistribuibile	API di mapping dei dati di livello inferiore microsoft NLS inWindows XP con SP2 e versioni successiveWindows Vista
Intestazione	Nlsdl.h
DLL	NlsMap.dll

Vedi anche

Supporto per la lingua nazionale
Funzioni di supporto per il linguaggio nazionale
Mapping dei dati delle impostazioni locali
LCIDToLocaleName

Share via