RESOLVER_CONTROL_BLOCK

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

• Windows Embedded CE 6.0 R3

8/28/2008

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