Funzione GetSystemDefaultLocaleName (winnls.h)

Articolo
03/13/2024

Recupera il nome delle impostazioni locali predefinite del sistema.

Nota È consigliabile che le applicazioni chiamino GetUserDefaultLocaleName in preferenza rispetto a questa funzione. Ciò è dovuto alle impostazioni locali dell'utente in genere più utili e accurate per l'utente rispetto alle impostazioni locali di sistema.

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

Sintassi

int GetSystemDefaultLocaleName(
  [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 di output indicato da lpLocaleName. La lunghezza massima possibile del carattere di un nome delle impostazioni locali (incluso un carattere null di terminazione) è il valore di LOCALE_NAME_MAX_LENGTH. Questa è la dimensione consigliata.

Valore restituito

Restituisce un valore maggiore di 0 che indica la lunghezza del nome delle impostazioni locali, incluso il carattere Null di terminazione, se ha esito positivo.

Questa 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.

Esempio

Un esempio che mostra l'uso di questa funzione è disponibile in NLS: Esempio di API basate su nome.

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