Поделиться через

Метод IDefaultLocation::GetReport (locationapi.h)

  • Статья

[API расположения Win32 доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте API Windows.Devices.Geolocation . ]

Извлекает указанный тип отчета из поставщика расположения по умолчанию.

Синтаксис

HRESULT GetReport(
  [in]  REFIID          reportType,
  [out] ILocationReport **ppLocationReport
);

Параметры

[in] reportType

REFIID , представляющий идентификатор интерфейса для типа извлекаемого отчета.

[out] ppLocationReport

Адрес указателя на ILocationReport , который получает указанный отчет о расположении от поставщика расположения по умолчанию.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Отчет о расположении успешно получен.
E_INVALIDARG
 параметр reportType отличается от IID_ILatLongReport или IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
 Данные недоступны. Это может быть вызвано отсутствием данных о расположении по умолчанию в реестре, повреждением данных в реестре или отсутствием поля Страна или регион в отчете о расположении по умолчанию.
E_POINTER
 ppLocationReport имеет значение NULL.

Комментарии

ILocationReport — это базовый интерфейс для конкретных типов отчетов о расположении. Фактический интерфейс, используемый для ppLocationReport, должен соответствовать типу, указанному в reportType.

Вызов IDefaultLocation::GetReport может привести к отображению уведомления на панели задач, а событие действия расположения будет зарегистрировано в Просмотр событий, если приложение впервые использует расположение.

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения],Windows 7
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header locationapi.h
DLL LocationAPI.dll

См. также раздел

Сведения об уведомлениях о расположении

Сведения об активности ведения журнала расположения

IDefaultLocation