Compartilhar via

Função GetUserDefaultGeoName (winnls.h)

  • Artigo

Recupera a localização geográfica padrão do usuário como um código de duas letras iso (Organização Internacional para Padronização) 3166-1, se disponível. Caso contrário, um código numérico da Série M das Nações Unidas (ONU), número 49 (M.49).

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 numérico da Organização Internacional para a Padronização (ISO) 3166-1 ou um código numérico da Série M das Nações Unidas (ONU), Número 49 (M.49).

[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.

Valor de retorno

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 que o geoName parâmetro especifica.

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.

Observações

Se o código ISO 3166-1 para a localização geográfica padrão do usuário for 'XX' (indicando que nenhum código foi atribuído), mas o local tem um código M.49 da ONU atribuído, o código M.49 será retornado como uma cadeia de caracteres decimal.

Se o código ISO 3166-1 para a localização geográfica padrão do usuário for 'XX' (o que indica que nenhum código foi atribuído), mas o local tem um código M.49 da ONU atribuído, o código M.49 é retornado como uma cadeia de caracteres decimal.

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 un m.49 numéricos, consulte códigos de área ou país Standard para uso estatístico (M49).

Requisitos

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

Consulte também