Metodo ILocation::SetReportInterval (locationapi.h)

Articolo
08/24/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 . ]

Specifica la quantità minima di tempo richiesta, espressa in millisecondi, tra gli eventi del report.

Sintassi

HRESULT SetReportInterval(
  [in] REFIID reportType,
  [in] DWORD  millisecondsRequested
);

Parametri

[in] reportType

REFIID che specifica il tipo di report per il quale impostare l'intervallo.

[in] millisecondsRequested

DWORD che contiene il valore dell'intervallo del report, espresso in millisecondi. Se questo valore è zero, non viene specificato alcun intervallo minimo e l'applicazione riceve gli eventi all'intervallo predefinito del sensore di posizione.

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 metodo è riuscito.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Il chiamante non è registrato per ricevere eventi per il tipo di report specificato.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	reportType diverso da IID_ILatLongReport o IID_ICivicAddressReport.

Commenti

L'intervallo richiesto tramite questo metodo rappresenta la quantità di tempo più breve tra gli eventi. Ciò significa che si richiede di ricevere notifiche degli eventi non più frequentemente di quanto specificato, ma il tempo trascorso potrebbe essere notevolmente più lungo. Usare questo metodo per garantire che le notifiche degli eventi non usino più risorse del processore rispetto alle esigenze.

Non è garantito che la richiesta per un determinato intervallo di report venga impostata dal provider di posizione. Chiamare GetReportInterval per individuare l'impostazione dell'intervallo di report reale.

Un intervallo di report pari a zero indica che non viene specificato alcun intervallo minimo e l'applicazione può ricevere eventi alla frequenza che il sensore di posizione invia gli eventi.

Esempio

Nell'esempio seguente viene illustrato come chiamare SetReportInterval.


// Set the latitude/longitude report interval to 1000 milliseconds
HRESULT hr = spLocation->SetReportInterval(IID_ILatLongReport, 1000);

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

ILocation

Condividi tramite