NewProviderReport
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
The Provider calls this Location Framework implemented callback function when it has a new report. A Provider only calls this function when the Location Framework has made a ProviderGetLocation request.
Syntax
DWORD NewProviderReport(
HANDLE provContext,
LOCATION_REPORT* pNewReport
);
Parameters
- provContext
[in] Handle of the calling Provider taken from the PROVIDER_CONTROL_BLOCK.
- pNewReport
[in] Address of a new report structure that has been generated.
Property Value/Return Value
ERROR_SUCCESS on success, an error code otherwise.
Providers should ignore the return code from this function and continue operating even if an error is returned. Providers should only stop operation when they receive a call to their ProviderStop export.
Remarks
This callback will result in a new Provider report being available for either applications of the Location Framework or resolvers to consume. It will put a plugin into the state PLUGIN_STATE_ON if it was not already in that state. After calling this function, the Provider should wait ProviderInformation.pollInterval milliseconds before calling again.
Requirements
| Header | lfplugin.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |