Funzione GetUserDefaultLocaleName (winnls.h)

  • Articolo

Recupera il nome delle impostazioni locali predefinite dell'utente.

Nota L'applicazione deve chiamare questa funzione in preferenza a GetUserDefaultLCID se progettata per l'esecuzione solo in Windows Vista e versioni successive.

 

Sintassi

int GetUserDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

Parametri

[out] lpLocaleName

Puntatore a un buffer in cui questa funzione recupera il nome delle impostazioni locali.

[in] cchLocaleName

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

Valore restituito

Restituisce le dimensioni del buffer contenente il nome delle impostazioni locali, incluso il carattere Null di terminazione, se l'operazione riesce.

Nota Nei sistemi a utente singolo il valore restituito corrisponde a quello restituito da GetSystemDefaultLocaleName.

 

La funzione restituisce 0 se non riesce. Per ottenere informazioni estese sull'errore, 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.

Commenti

Questa funzione può recuperare dati dalle impostazioni locali personalizzate. Non è garantito che i dati siano gli stessi dal computer al computer o tra le esecuzioni di un'applicazione. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Uso dei dati delle impostazioni locali persistenti.

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 (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale