ILocation：：SetReportInterval 方法 (locationapi.h)

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

指定報告事件之間要求的最小時間量，以毫秒為單位。

語法

HRESULT SetReportInterval(
  [in] REFIID reportType,
  [in] DWORD  millisecondsRequested
);

[in] reportType

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

[in] millisecondsRequested

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

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

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

您使用此方法要求的間隔代表事件之間的最短時間量。這表示您要求接收事件通知的頻率不會超過指定，但經過的時間可能會明顯更長。使用此方法有助於確保事件通知不會使用比必要更多的處理器資源。

不保證您的特定報表間隔要求將由位置提供者設定。呼叫 GetReportInterval 以探索真正的報表間隔設定。

報告間隔為零表示未指定最小間隔，而且應用程式可能會以定位感應器傳送事件的頻率接收事件。

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


// Set the latitude/longitude report interval to 1000 milliseconds
HRESULT hr = spLocation->SetReportInterval(IID_ILatLongReport, 1000);