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
S_OK	Die Methode wurde erfolgreich ausgeführt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	reportType war nicht IID_ILatLongReport oder IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Der Aufrufer ist nicht registriert, um Ereignisse für den angegebenen Berichtstyp zu empfangen.
E_INVALIDARG	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

Weitere Informationen

ILocation