Funzione GetNLSVersion (winnls.h)

Articolo
03/08/2023

Recupera informazioni sulla versione corrente di una funzionalità NLS specificata per le impostazioni locali specificate dall'identificatore.

Nota Per motivi di interoperabilità, l'applicazione deve preferire la funzione GetNLSVersionEx a GetNLSVersion perché Microsoft sta eseguendo la migrazione all'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali. Questa raccomandazione si applica in particolare alle impostazioni locali personalizzate, per cui GetNLSVersionEx recupera informazioni sufficienti per determinare se il comportamento di ordinamento è cambiato. Qualsiasi applicazione eseguita solo in Windows Vista e versioni successive deve usare GetNLSVersionEx o almeno passare la struttura NLSVERSIONINFOEX quando si chiama GetNLSVersion per ottenere dati aggiuntivi sul controllo delle versioni.

Sintassi

BOOL GetNLSVersion(
  [in]      NLS_FUNCTION     Function,
  [in]      LCID             Locale,
  [in, out] LPNLSVERSIONINFO lpVersionInformation
);

Parametri

[in] Function

Funzionalità NLS di cui eseguire query. Questo valore deve essere COMPARE_STRING. Vedere l'enumerazione SYSNLS_FUNCTION .

[in] Locale

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

Windows Vista e versioni successive: Sono supportati anche gli identificatori di impostazioni locali personalizzati seguenti.

[in, out] lpVersionInformation

Puntatore a una struttura NLSVERSIONINFO . L'applicazione deve inizializzare il membro dwNLSVersionInfoSize su sizeof(NLSVERSIONINFO).

Nota In Windows Vista e versioni successive, la funzione può in alternativa fornire informazioni sulla versione in una struttura NLSVERSIONINFOEX .

Valore restituito

Restituisce TRUE se e solo se l'applicazione ha specificato valori validi in lpVersionInformation o FALSE in caso contrario. 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.
ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Commenti

Questa funzione consente a un'applicazione come Active Directory di determinare se una modifica NLS influisce sull'identificatore delle impostazioni locali usato per una determinata tabella di indice. In caso contrario, non è necessario reindicizzazione della tabella. Per altre informazioni, vedere Gestione dell'ordinamento nelle applicazioni.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll