ILocation::GetReportInterval 方法 (locationapi.h)

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

检索报告事件之间请求的时间(以毫秒为单位)。

语法

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

parameters

[in] reportType

REFIID ,指定要获取其间隔的报告类型。

[out] pMilliseconds

接收报告间隔值的 DWORD 的地址(以毫秒为单位)。 如果未注册报表,则会将其设置为 NULL。 如果此值设置为零,则不指定最小间隔,并且应用程序将按位置传感器的默认间隔接收事件。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
reportType 不同于 IID_ILatLongReportIID_ICivicAddressReport
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
调用方未注册为接收指定报告类型的事件。
E_INVALIDARG
pMillisecondsNULL

注解

在调用此方法之前,必须调用 RegisterForReport

示例

以下示例演示如何调用 GetReportInterval


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

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用],Windows 7
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 locationapi.h
DLL LocationAPI.dll

另请参阅

ILocation