Share via


RESOLVER_CONTROL_BLOCK (Windows Embedded CE 6.0)

1/6/2010

The Location Framework passes a RESOLVER_CONTROL_BLOCK to a Resolver during its call to ResolverGetLocation. This block contains various information such as the report that should be resolved, which type(s) it should be resolved to, and a callback function to the Location Framework itself to indicate when new reports have been generated.

Syntax

typedef struct _RESOLVER_CONTROL_BLOCK {
    DWORD                 version;
    HANDLE                resContext;
     RESOLVER_INFORMATION* pResInfo;
    LOCATION_REPORT*      provReport;
    GUID                  typesToResolve[MAX_PLUGIN_REPORT_TYPES];
    DWORD                 numTypesToResolve;
    DWORD (WINAPI* NewResolverReport)(HANDLE resContext, LOCATION_REPORT* pNewReport);
} RESOLVER_CONTROL_BLOCK, *PRESOLVER_CONTROL_BLOCK;

Members

  • version
    The version of the Location Framework making this call. This value will always be the value of LOCATION_FRAMEWORK_VERSION_CURRENT that the version of Location Framework on the system was created under.
  • resContext
    This contains a context value indicating the Resolver itself. This resContext must be used by the Resolver when calling back into the Location Framework.
  • pResInfo
    This is a pointer to a RESOLVER_INFORMATION structure that contains configuration information about the plugin. The Location Framework only reads in information such as poll interval from the registry; it is the Resolver’s responsibility to actually honor these configuration settings.
  • provReport
    This is a pointer to a report that should be translated by the Resolver. This could be for instance a lat/long report type. In the current version of the Location Framework, only reports generated by Provider DLLs can be transformed using a resolver. In future versions, however, the capability for a Resolver to resolve report types generated by another Resolver may be added. Therefore the Resolver must not assume that this report was generated by a Provider DLL.
  • typesToResolve
    An array of GUIDs listing the report types that this resolver should resolve. If LOCATION_ADDRESS_GUID and LOCATION_BUILDING_GUID were the elements of this array, it would indicate that the Resolver should resolve the provReport into both the country/region/city/address and building/room/floor it corresponds to. The Location Framework only passes in types that have been explicitly requested by an application in this array, so Resolvers should honor this request and not resolve all report types they are theoretically capable of resolving.
  • numTypesToResolve
    The number of valid entries in the typesToResolve array.
  • NewResolverReport
    Indicates the callback function that the Resolver calls when a new report is available.

Requirements

Header lfplugin.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

Location Framework Plugin Structures
RESOLVER_INFORMATION
ResolverGetLocation