IDefaultLocation：：GetReport 方法 (locationapi.h)
[Win32 位置 API 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 Windows.Devices.Geolocation API。 ]
從預設位置提供者擷取指定的報表類型。
語法
HRESULT GetReport(
[in] REFIID reportType,
[out] ILocationReport **ppLocationReport
);
參數
[in] reportType
REFIID ，表示所擷取報表類型的介面識別碼。
[out] ppLocationReport
從預設位置提供者接收指定位置報表之 ILocationReport 指標的位址。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
已成功擷取位置報表。 |
|
reportType 不是 IID_ILatLongReport 或 IID_ICivicAddressReport。 |
|
沒有可用的資料。 這可能是因為登錄中缺少預設位置資料、登錄中的資料損毀，或預設位置報告中遺漏的 [國家/地區] 欄位。 |
|
ppLocationReport 為 Null。 |
備註
ILocationReport 是特定位置報表類型的基底介面。 您用於 ppLocationReport 的實際介面必須符合您透過 reportType指定的類型。
呼叫IDefaultLocation：：GetReport可能會導致在工作列中顯示通知，如果它是應用程式第一次使用位置，則會在事件檢視器中記錄位置活動事件。
需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式]，Windows 7 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | locationapi.h |
| Dll | LocationAPI.dll |