ILocation::GetReportInterval-Methode (locationapi.h)
[Die Win32-Standort-API ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows.Devices.Geolocation-API . ]
Ruft die angeforderte Zeit in Millisekunden zwischen Berichtsereignissen ab.
Syntax
HRESULT GetReportInterval(
[in] REFIID reportType,
[out] DWORD *pMilliseconds
);
Parameter
[in] reportType
REFIID , die den Berichtstyp angibt, für den das Intervall abgerufen werden soll.
[out] pMilliseconds
Die Adresse eines DWORD-Werts , der den Berichtsintervallwert in Millisekunden empfängt. Wenn der Bericht nicht registriert ist, wird dies auf NULL festgelegt. Wenn dieser Wert auf Null festgelegt ist, wird kein Mindestintervall angegeben, und Ihre Anwendung empfängt Ereignisse im Standardintervall des Standortsensors.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
reportType war nicht IID_ILatLongReport oder IID_ICivicAddressReport. |
|
Der Aufrufer ist nicht registriert, um Ereignisse für den angegebenen Berichtstyp zu empfangen. |
|
pMillisekunden ist NULL. |
Hinweise
Sie müssen RegisterForReport aufrufen, bevor Sie diese Methode aufrufen.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie GetReportInterval aufgerufen wird.
DWORD reportInterval = 0;
HRESULT hr = spLocation->GetReportInterval(IID_ILatLongReport, &reportInterval);
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps],Windows 7 |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | locationapi.h |
| DLL | LocationAPI.dll |