Share via


NewProviderReport

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

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

See Also

Reference

Location Framework Plugin Callback Functions