Funzione LCIDToLocaleName (winnls.h)

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

Nota Per le impostazioni locali personalizzate, incluse quelle create da Microsoft, le applicazioni devono preferire i nomi delle impostazioni locali sugli identificatori delle impostazioni locali.

 

Sintassi

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

Parametri

[in] Locale

Identificatore delle impostazioni locali da tradurre. È possibile usare la macro MAKELCID per creare un identificatore delle impostazioni locali o usare uno dei valori predefiniti seguenti.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista: Sono supportati anche gli identificatori delle impostazioni locali personalizzate seguenti.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

Puntatore a un buffer in cui questa funzione recupera il nome delle impostazioni locali o uno dei valori predefiniti seguenti.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] cchName

Dimensioni, in caratteri, del buffer dei nomi delle impostazioni locali. La lunghezza massima possibile di un nome delle impostazioni locali, incluso un carattere Null terminante, è LOCALE_NAME_MAX_LENGTH. Questa è la dimensione consigliata da specificare per questo parametro.

In alternativa, l'applicazione può impostare questo parametro su 0. In questo caso, la funzione restituisce le dimensioni necessarie per il buffer dei nomi delle impostazioni locali.

[in] dwFlags

Prima di Windows 7: Riservati; deve sempre essere 0.

A partire da Windows 7: Può essere impostato su LOCALE_ALLOW_NEUTRAL_NAMES per consentire la restituzione di un nome neutrale.

Valore restituito

Restituisce il numero di caratteri, incluso il carattere Null terminante, nel nome delle impostazioni locali, se riuscito. Se la funzione ha esito positivo e il valore di cchName è 0, il valore restituito è la dimensione necessaria, in caratteri (inclusi null), per il buffer dei nomi delle impostazioni locali.

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

• ERROR_INSUFFICIENT_BUFFER. Una dimensione del buffer fornita non è stata sufficiente oppure è stata impostata in modo errato su NULL.
• ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

LocaleNameToLCID

Supporto per la lingua nazionale

Funzioni di supporto del linguaggio nazionale