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 |
|---|---|
|
Um valor de parâmetro não era válido. |
|
A função não pôde ler informações do registro. |
|
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 |