IDefaultLocation::GetReport-Methode (locationapi.h)
[Die Win32-Standort-API ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows.Devices.Geolocation-API . ]
Ruft den angegebenen Berichtstyp vom Standardspeicherortsanbieter ab.
Syntax
HRESULT GetReport(
[in] REFIID reportType,
[out] ILocationReport **ppLocationReport
);
Parameter
[in] reportType
REFIID , die die Schnittstellen-ID für den Typ des abgerufenen Berichts darstellt.
[out] ppLocationReport
Die Adresse eines Zeigers auf ILocationReport , der den angegebenen Speicherortbericht vom Standardspeicherortanbieter empfängt.
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 |
|---|---|
|
Der Speicherortbericht wurde erfolgreich abgerufen. |
|
reportType ist nicht IID_ILatLongReport oder IID_ICivicAddressReport. |
|
Es sind keine Daten verfügbar. Dies kann auf fehlende Standardspeicherortdaten in der Registrierung, beschädigte Daten in der Registrierung oder ein fehlendes Feld "Land/Region" im Standardspeicherortbericht zurückzuführen sein. |
|
ppLocationReport ist NULL. |
Hinweise
ILocationReport ist die Basisschnittstelle für bestimmte Standortberichtstypen. Die tatsächliche Schnittstelle, die Sie für ppLocationReport verwenden, muss mit dem Typ übereinstimmen, den Sie über reportType angegeben haben.
Ein Aufruf von IDefaultLocation::GetReport kann dazu führen, dass eine Benachrichtigung in der Taskleiste angezeigt wird und ein Location Activity-Ereignis in Ereignisanzeige protokolliert wird, wenn dies die erste Verwendung des Standorts durch die Anwendung ist.
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
Informationen zu Standortbenachrichtigungen