Método IDefaultLocation::GetReport (locationapi.h)
[A API de Localização do Win32 está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use a API Windows.Devices.Geolocation . ]
Recupera o tipo de relatório especificado do provedor de localização padrão.
Sintaxe
HRESULT GetReport(
[in] REFIID reportType,
[out] ILocationReport **ppLocationReport
);
Parâmetros
[in] reportType
REFIID que representa a ID da interface para o tipo de relatório que está sendo recuperado.
[out] ppLocationReport
O endereço de um ponteiro para ILocationReport que recebe o relatório de localização especificado do provedor de localização padrão.
Valor retornado
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O relatório de localização foi recuperado com êxito. |
|
reportType é diferente de IID_ILatLongReport ou IID_ICivicAddressReport. |
|
Nenhum dado está disponível. Isso pode ocorrer devido à falta de dados de localização padrão no registro, dados corrompidos no registro ou a um campo País/Região ausente no relatório de localização padrão. |
|
ppLocationReport é NULL. |
Comentários
ILocationReport é a interface base para tipos de relatório de localização específicos. A interface real usada para ppLocationReport deve corresponder ao tipo especificado por meio de reportType.
Uma chamada para IDefaultLocation::GetReport pode resultar na exibição de uma notificação na barra de tarefas e um evento de Atividade de Localização sendo registrado em Visualizador de Eventos, se for o primeiro uso do local pelo aplicativo.
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho], Windows 7 |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | locationapi.h |
| DLL | LocationAPI.dll |
Confira também
Sobre notificações de localização