GetGeoInfoEx, fonction (winnls.h)

  • Article

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