Condividi tramite


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.

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

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.

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