Funzione DownlevelGetParentLocaleName

Recupera il nome delle impostazioni locali per l'elemento padre delle impostazioni locali fornite.

Nota

Questa funzione viene usata solo dalle applicazioni eseguite nei sistemi operativi pre-Windows Vista. L'uso richiede il pacchetto di download. Le applicazioni eseguite solo in Windows Vista e versioni successive devono chiamare GetLocaleInfo con LCType impostato su LOCALE_SPARENT.

 

Sintassi

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Parametri

Impostazioni locali [in]

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

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_Uedizione StandardR_DEFAULT

Windows Vista e versioni successive: sono supportati anche gli identificatori delle impostazioni locali personalizzati seguenti.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

Puntatore a un buffer in cui la funzione recupera il nome delle impostazioni locali padre o uno dei valori predefiniti seguenti. Questo parametro è impostato su NULL se cchName è impostato su 0.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_Uedizione StandardR_DEFAULT

cchName [in]

Dimensioni del buffer indicato da lpName, in punti di codice UTF-16. Un valore pari a 0 per questo parametro fa sì che la funzione ignori il buffer lpName e restituisca le dimensioni del buffer, in caratteri (caratteri Null inclusi), necessaria per contenere il nome delle impostazioni locali padre.

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.

Questa 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_PARAMETER. Uno dei valori dei parametri non è valido.

Osservazioni:

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

GetLocaleInfo