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。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
reportType 不同于 IID_ILatLongReport 或 IID_ICivicAddressReport。 |
|
调用方未注册为接收指定报告类型的事件。 |
|
pMilliseconds 为 NULL。 |
注解
在调用此方法之前,必须调用 RegisterForReport 。
示例
以下示例演示如何调用 GetReportInterval。
DWORD reportInterval = 0;
HRESULT hr = spLocation->GetReportInterval(IID_ILatLongReport, &reportInterval);
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用],Windows 7 |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | locationapi.h |
DLL | LocationAPI.dll |