ResolverInitialize
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
A Resolver DLL implements this function. The Location Framework calls this export during its initialization, immediately after loading the Resolver DLL.
Syntax
DWORD ResolverInitialize(
RESOLVER_INFORMATION* pResInfo
);
Parameters
- pResInfo
Pointer to a RESOLVER_INFORMATION structure containing configuration information about the Resolver DLL that the Location Framework read from the registry.
Return Value
The Resolver should return ERROR_SUCCESS if initialization succeeds or return an error code otherwise. If the function does not return ERROR_SUCCESS, the plugin will be immediately stopped.
Remarks
There are a number of functions that are not safe to be called in DllMain, such as spinning threads, using winsock, COM, or any other calls that may cause other libraries to be loaded. Such operations should be performed in this function instead.
The Location Framework loads initialization functions serially. Resolvers must not block for long periods of time in this function. Doing so will halt the Location Frameworkâs initialization and also that of servicesd.exe.
The RESOLVER_INFORMATION structure passed in does not need to be copied by the Resolver for future reference. It will also be passed in on subsequent calls to ResolverGetLocation.
Requirements
| Header | lfplugin.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |