Metodo IDefaultLocation::GetReport (locationapi.h)

Articolo
03/14/2023

[L'API Location Win32 è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece l'API Windows.Devices.Geolocation . ]

Recupera il tipo di report specificato dal provider di percorsi predefinito.

Sintassi

HRESULT GetReport(
  [in]  REFIID          reportType,
  [out] ILocationReport **ppLocationReport
);

Parametri

[in] reportType

REFIID che rappresenta l'ID interfaccia per il tipo di report recuperato.

[out] ppLocationReport

Indirizzo di un puntatore a ILocationReport che riceve il report del percorso specificato dal provider di percorsi predefinito.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il report relativo alla posizione è stato recuperato correttamente.
E_INVALIDARG	reportType è diverso da IID_ILatLongReport o IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Nessun dato disponibile. Ciò può essere dovuto alla mancanza di dati di posizione predefiniti nel Registro di sistema, a dati danneggiati nel Registro di sistema o a un campo Paese/area geografica mancante nel report percorso predefinito.
E_POINTER	ppLocationReport è NULL.

Commenti

ILocationReport è l'interfaccia di base per tipi di report di posizione specifici. L'interfaccia effettiva usata per ppLocationReport deve corrispondere al tipo specificato tramite reportType.

Una chiamata a IDefaultLocation::GetReport può comportare la visualizzazione di una notifica nella barra delle applicazioni e un evento Location Activity registrato Visualizzatore eventi, se è il primo uso della posizione dell'applicazione.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop],Windows 7
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	locationapi.h
DLL	LocationAPI.dll

Vedi anche

Informazioni sulle notifiche relative alla posizione

Informazioni sull'attività Relativa alla posizione di registrazione

IDefaultLocation

Condividi tramite