Fonction GetNLSVersion (winnls.h)

Article
08/27/2023

Récupère des informations sur la version actuelle d’une fonctionnalité NLS spécifiée pour un paramètre régional spécifié par l’identificateur.

Note Pour des raisons d’interopérabilité, l’application doit préférer la fonction GetNLSVersionEx à GetNLSVersion , car Microsoft migre vers l’utilisation de noms régionaux au lieu d’identificateurs régionaux pour les nouveaux paramètres régionaux. Cette recommandation s’applique en particulier aux paramètres régionaux personnalisés, pour lesquels GetNLSVersionEx récupère suffisamment d’informations pour déterminer si le comportement de tri a changé. Toute application qui s’exécute uniquement sur Windows Vista et versions ultérieures doit utiliser GetNLSVersionEx ou au moins passer la structure NLSVERSIONINFOEX lors de l’appel de GetNLSVersion pour obtenir des données de contrôle de version supplémentaires.

Syntaxe

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

Paramètres

[in] Function

Fonctionnalité NLS à interroger. Cette valeur doit être COMPARE_STRING. Consultez l’énumération SYSNLS_FUNCTION .

[in] Locale

Identificateur de paramètres régionaux qui spécifie les paramètres régionaux. Vous pouvez utiliser la macro MAKELCID pour créer un identificateur ou utiliser l’une des valeurs prédéfinies suivantes.

Windows Vista et versions ultérieures : Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.

[in, out] lpVersionInformation

Pointeur vers une structure NLSVERSIONINFO . L’application doit initialiser le membre dwNLSVersionInfoSize en sizeof(NLSVERSIONINFO).

Note Sur Windows Vista et versions ultérieures, la fonction peut également fournir des informations de version dans une structure NLSVERSIONINFOEX .

Valeur retournée

Retourne TRUE si et uniquement si l’application a fourni des valeurs valides dans lpVersionInformation, ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

ERROR_INSUFFICIENT_BUFFER. Une taille de mémoire tampon fournie n’était pas assez grande ou elle a été incorrectement définie sur NULL.
ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.

Remarques

Cette fonction permet à une application telle qu’Active Directory de déterminer si une modification NLS affecte l’identificateur de paramètres régionaux utilisé pour une table d’index particulière. Si ce n’est pas le cas, il n’est pas nécessaire de réindexer la table. Pour plus d’informations, consultez Gestion du tri dans vos applications.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll