GetGeoInfoEx, fonction (winnls.h)

Article
03/04/2024

Récupère des informations sur un emplacement géographique que vous spécifiez à l’aide d’un code 3166-1 à deux lettres de l’Organisation internationale de normalisation (ISO) ou d’un code numérique série M, numéro 49 (M.49) des Nations Unies.

Syntaxe

int GetGeoInfoEx(
  [in]            PWSTR   location,
  [in]            GEOTYPE geoType,
  [out, optional] PWSTR   geoData,
  [in]            int     geoDataCount
);

Paramètres

[in] location

Code ISO 3166-1 à deux lettres ou numérique UN M.49 pour l’emplacement géographique pour lequel obtenir des informations. Pour obtenir les codes disponibles sur le système d’exploitation, appelez EnumSystemGeoNames.

[in] geoType

Type d’informations que vous souhaitez récupérer. Les valeurs possibles sont définies par l’énumération SYSGEOTYPE . Les valeurs suivantes de l’énumération SYSGEOTYPE ne doivent pas être utilisées avec GetGeoInfoEx :

GEO_ID
Cette valeur est fournie pour des raisons de compatibilité descendante. N’utilisez pas cette valeur dans les nouvelles applications, mais utilisez GEO_NAME à la place.
GEO_LCID
Cette valeur n’est pas prise en charge pour la fonction GetGeoInfoEx .
GEO_NATION
Cette valeur n’est pas prise en charge pour la fonction GetGeoInfoEx .
GEO_RFC1766
Cette valeur n’est pas prise en charge pour la fonction GetGeoInfoEx .

[out, optional] geoData

Pointeur vers la mémoire tampon dans laquelle GetGeoInfoEx doit écrire les informations demandées.

[in] geoDataCount

Taille de la mémoire tampon vers laquelle pointe le paramètre GeoData , en caractères. Définissez ce paramètre sur 0 pour spécifier que la fonction doit retourner uniquement la taille de la mémoire tampon requise pour stocker les informations demandées sans écrire les informations demandées dans la mémoire tampon.

Valeur retournée

Nombre d’octets d’informations d’emplacement géographique que la fonction a écrits dans la mémoire tampon de sortie. Si geoDataCount a la valeur 0, la fonction retourne la taille de la mémoire tampon nécessaire pour contenir les informations sans écrire les informations dans la mémoire tampon.

0 indique que la fonction n’a pas réussi. Pour obtenir des informations d’erreur étendues, appelez GetLastError, qui peut retourner l’un des codes d’erreur suivants :

Code de retour	Description
ERROR_INSUFFICIENT_BUFFER	La taille de la mémoire tampon fournie n’était pas suffisamment grande ou a été incorrectement définie sur NULL.
ERROR_INVALID_PARAMETER	Une valeur de paramètre n’était pas valide.
ERROR_INVALID_FLAGS	Les valeurs fournies pour les indicateurs n’étaient pas valides.

Remarques

Pour plus d’informations sur les codes ISO 3166-1 à deux lettres, consultez Codes pays - ISO 3166. Pour plus d’informations sur les codes numériques UN M.49, consultez Codes de pays ou de zone standard à usage statistique (M49).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	winnls.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

EnumSystemGeoNames

GetGeoInfo

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

SYSGEOTYPE

Partager via