IDefaultLocation：：GetReport 方法 (locationapi.h)

[Win32 位置 API 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。请改用 Windows.Devices.Geolocation API。 ]

从默认位置提供程序检索指定的报表类型。

语法

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

[in] reportType

REFIID ，表示要检索的报表类型的接口 ID。

[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 可能会导致在任务栏中显示通知，并且位置活动事件记录在事件查看器（如果这是应用程序首次使用位置）。