Méthode IDefaultLocation::GetReport (locationapi.h)

Article
08/24/2023

[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 le type de rapport spécifié à partir du fournisseur d’emplacement par défaut.

Syntaxe

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

Paramètres

[in] reportType

REFIID représentant l’ID d’interface du type de rapport récupéré.

[out] ppLocationReport

Adresse d’un pointeur vers ILocationReport qui reçoit le rapport d’emplacement spécifié du fournisseur d’emplacement par défaut.

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	Le rapport d’emplacement a été récupéré avec succès.
E_INVALIDARG	reportType n’est pas IID_ILatLongReport ou IID_ICivicAddressReport.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	Aucune donnée n’est disponible. Cela peut être dû à un manque de données d’emplacement par défaut dans le registre, à des données endommagées dans le registre ou à un champ Pays/Région manquant dans le rapport d’emplacement par défaut.
E_POINTER	ppLocationReport a la valeur NULL.

Notes

ILocationReport est l’interface de base pour des types de rapports d’emplacement spécifiques. L’interface réelle que vous utilisez pour ppLocationReport doit correspondre au type que vous avez spécifié via reportType.

Un appel à IDefaultLocation::GetReport peut entraîner l’affichage d’une notification dans la barre des tâches et la journalisation d’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.

Spécifications


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

Voir aussi

À propos des notifications d’emplacement

À propos de l’activité d’emplacement de journalisation

IDefaultLocation

Partager via