Partager via

GetUserDefaultGeoName, fonction (winnls.h)

Récupère l’emplacement géographique par défaut de l’utilisateur en tant qu’organisation internationale de normalisation (ISO) 3166-1 code à deux lettres, le cas échéant. Dans le cas contraire, un code numérique de la série DES Nations Unies (ONU), numéro 49 (M.49).

Syntax

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Parameters

[out] geoName

Pointeur vers une mémoire tampon dans laquelle cette fonction doit écrire le code numérique 3166-1 à deux lettres de l’Organisation internationale de normalisation (ISO) 3166-1 ou un code numérique de série ONU (ONU), numéro 49 (M.49).

[in] geoNameCount

The size of the buffer that the geoName parameter specifies. Si cette valeur est égale à zéro, la fonction retourne uniquement le nombre de caractères que la fonction copierait dans la mémoire tampon de sortie, mais n’écrit pas le nom de l’emplacement géographique par défaut de l’utilisateur dans la mémoire tampon.

Return value

The number of characters the function would copy to the output buffer if the value of the geoNameCount parameter is zero. Otherwise, the number of characters that the function copied to the buffer that the geoName parameter specifies.

Zéro indique que la fonction a échoué. To get extended error information, call GetLastError, which can return one of the following error codes:

Return code Description
ERROR_INVALID_PARAMETER Une valeur de paramètre n’était pas valide.
ERROR_BADDB La fonction n’a pas pu lire les informations du Registre.
ERROR_INSUFFICIENT_BUFFER The buffer that the geoName parameter specifies is too small for the string.

Remarks

Si le code ISO 3166-1 de l’emplacement géographique par défaut de l’utilisateur est « XX » (ce qui indique qu’aucun code n’a été affecté), mais que l’emplacement a un code UN M.49 affecté, le code M.49 est retourné sous forme de chaîne décimale.

Pour plus d’informations sur les codes ISO 3166-1 à deux lettres, consultez codes de pays ISO 3166.

Pour plus d’informations sur les codes NUMÉRIQUES UN M.49, consultez codes de pays ou de zones standard pour une utilisation statistique (M49).

Requirements

Requirement Value
client minimum pris en charge Windows 10, version 1709 [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2016 [applications de bureau uniquement]
Target Platform Windows
Header winnls.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also