Méthode ILocation ::GetReport (locationapi.h)
[L’API d’emplacement Win32 peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt l’API Windows.Devices.Geolocation . ]
Récupère un rapport d’emplacement.
Syntaxe
HRESULT GetReport(
[in] REFIID reportType,
[out] ILocationReport **ppLocationReport
);
Paramètres
[in] reportType
REFIID qui spécifie le type de rapport à récupérer.
[out] ppLocationReport
Adresse d’un pointeur vers ILocationReport qui reçoit le rapport d’emplacement spécifié.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
Code de retour | Description |
---|---|
|
S_OK |
|
Les autorisations du fournisseur d’emplacement sont désactivées et les données de rapport ne peuvent pas être récupérées. |
|
reportType n’est pas IID_ILatLongReport ou IID_ICivicAddressReport. |
|
Aucune donnée n’est disponible. Cela peut être dû à une erreur ou à l’indisponibilité du fournisseur. |
|
ppLocationReport a la valeur NULL. |
|
reportType est IID_ILatLongReport, et la valeur de latitude ou de longitude est hors limites. |
|
Le capteur sous-jacent est NULL ou déconnecté. |
|
Mémoire insuffisante. |
Remarques
ILocationReport est l’interface de base pour des types de rapports d’emplacement spécifiques. Appelez QueryInterface pour récupérer un pointeur vers le type de rapport correct.
Lorsque GetReport est appelé, une notification peut s’afficher dans la barre des tâches et enregistrer un événement Activité d’emplacement observateur d'événements, s’il s’agit de la première utilisation de l’emplacement par l’application.
Exemples
L’exemple suivant appelle GetReport pour les rapports de latitude/longitude et montre comment appeler QueryInterface pour récupérer un pointeur vers le type de rapport spécifié.
CComPtr<ILocationReport> spLocationReport; // This is our location report object
CComPtr<ILatLongReport> spLatLongReport; // This is our LatLong report object
// Get the current latitude/longitude location report,
hr = spLocation->GetReport(IID_ILatLongReport, &spLocationReport);
// then get a pointer to the ILatLongReport interface by calling QueryInterface
if (SUCCEEDED(hr))
{
hr = spLocationReport->QueryInterface(&spLatLongReport);
}
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 7 [applications de bureau uniquement],Windows 7 |
Serveur minimal pris en charge | Aucun pris en charge |
Plateforme cible | Windows |
En-tête | locationapi.h |
DLL | LocationAPI.dll |