ILocation：：GetReportInterval 方法 (locationapi.h)

[Win32 位置 API 可用於需求一節中指定的作業系統。它在後續版本中可能會變更或無法使用。請改用 Windows.Devices.Geolocation API。 ]

擷取報表事件之間的要求時間量，以毫秒為單位。

語法

HRESULT GetReportInterval(
  [in]  REFIID reportType,
  [out] DWORD  *pMilliseconds
);

[in] reportType

REFIID ，指定要取得間隔的報表類型。

[out] pMilliseconds

接收報表間隔值的 DWORD 位址，以毫秒為單位。如果未註冊報表，這將會設定為 Null。如果此值設定為零，則不會指定最小間隔，而且您的應用程式會在定位感應器的預設間隔接收事件。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	reportType 非 IID_ILatLongReport 或 IID_ICivicAddressReport。
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)	呼叫端未註冊以接收指定之報表類型的事件。
E_INVALIDARG	pMilliseconds 為 Null。

您必須先呼叫 RegisterForReport ，才能呼叫此方法。

下列範例示範如何呼叫 GetReportInterval。


DWORD reportInterval = 0;
HRESULT hr = spLocation->GetReportInterval(IID_ILatLongReport, &reportInterval);