Metodo ILocation::GetReportInterval (locationapi.h)

Articolo
03/14/2023

[L'API Percorso 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 la quantità di tempo richiesta, in millisecondi, tra eventi del report.

Sintassi

HRESULT GetReportInterval(
  [in]  REFIID reportType,
  [out] DWORD  *pMilliseconds
);

Parametri

[in] reportType

REFIID che specifica il tipo di report per cui ottenere l'intervallo.

[out] pMilliseconds

Indirizzo di un DWORD che riceve il valore dell'intervallo di report, in millisecondi. Se il report non è registrato, verrà impostato su NULL. Se questo valore è impostato su 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 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_NOT_SUPPORTED)	reportType è diverso da IID_ILatLongReport o IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Il chiamante non è registrato per ricevere eventi per il tipo di report specificato.
E_INVALIDARG	pMilliseconds è NULL.

Commenti

È necessario chiamare RegisterForReport prima di chiamare questo metodo.

Esempio

Nell'esempio seguente viene illustrato come chiamare GetReportInterval.


DWORD reportInterval = 0;
HRESULT hr = spLocation->GetReportInterval(IID_ILatLongReport, &reportInterval);

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