Partilhar via

Função GetUserDefaultGeoName (winnls.h)

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

Syntax

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

Parameters

[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

The size of the buffer that the geoName parameter specifies. 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.

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.

Zero indica que a função falhou. To get extended error information, call GetLastError, which can return one of the following error codes:

Return code Description
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 The buffer that the geoName parameter specifies is too small for the string.

Remarks

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

Requirements

Requirement Value
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]
Target Platform Windows
Header winnls.h (inclua Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also

  • Last updated on