Função GetUserDefaultGeoName (winnls.h)

Recupera o código iso 3166-1 da Organização Internacional para a Padronização (ISO) de duas letras ou o código da Série M das Nações Unidas (ONU), número 49 (M.49) para a localização geográfica padrão do usuário.

Sintaxe

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

Parâmetros

[out] geoName

Ponteiro para um buffer no qual essa função deve gravar o código ISO 3166-1 ou NUMERIC UN M.49 encerrado em nulo para a localização geográfica padrão do usuário.

[in] geoNameCount

O tamanho do buffer especificado pelo parâmetro geoName . Se esse valor for zero, a função retornará apenas o número de caracteres que a função copiaria para o buffer de saída, mas não gravará o nome da localização geográfica padrão do usuário no buffer.

Retornar valor

O número de caracteres que a função copiaria para o buffer de saída, se o valor do parâmetro geoNameCount for zero. Caso contrário, o número de caracteres que a função copiou para o buffer especificado pelo parâmetro geoName .

Zero indica que a função falhou. Para obter informações de erro estendidas, chame GetLastError, que pode retornar um dos seguintes códigos de erro:

Código de retorno Descrição
ERROR_INVALID_PARAMETER
Um valor de parâmetro não era válido.
ERROR_BADDB
A função não pôde ler informações do registro.
ERROR_INSUFFICIENT_BUFFER
O buffer especificado pelo parâmetro geoName é muito pequeno para a cadeia de caracteres.

Comentários

Para obter informações sobre códigos ISO 3166-1 de duas letras, consulte Códigos de país – ISO 3166. Para obter informações sobre códigos numéricos do UN M.49, consulte Códigos de área ou país padrão para uso estatístico (M49).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetUserGeoID

Suporte à linguagem nacional

Funções de suporte à linguagem nacional

SetUserGeoName