ILocation interface (locationapi.h)

[The Win32 Location API is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the Windows.Devices.GeolocationAPI. ]

Provides methods used to manage location reports, event registration, and sensor permissions.


The ILocation interface inherits from the IUnknown interface. ILocation also has these types of members:


The ILocation interface has these methods.

Method Description
ILocation::GetDesiredAccuracy Retrieves the current requested accuracy setting.
ILocation::GetReport Retrieves a location report.
ILocation::GetReportInterval Retrieves the requested amount of time, in milliseconds, between report events.
ILocation::GetReportStatus Retrieves the status for the specified report type.
ILocation::RegisterForReport Requests location report events.
ILocation::RequestPermissions Opens a system dialog box to request user permission to enable location devices.
ILocation::SetDesiredAccuracy Specifies the accuracy to be used.
ILocation::SetReportInterval Specifies the requested minimum amount of time, in milliseconds, between report events.
ILocation::UnregisterForReport Stops event notifications for the specified report type.


When CoCreateInstance is callled to create an ILocation object, it may result in a notification being displayed in the taskbar, and a Location Activity event being logged in Event Viewer, if it is the application's first use of location.


Minimum supported client Windows 7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header locationapi.h