MSProviderInit
The MSProviderInit
function initializes a message store provider for operation.
Quick Info
|
Header
file: |
MAPISPI.H |
|
Implemented
by: |
Message
store providers |
|
Called by: |
MAPI |
HRESULT MSProviderInit(
|
HINSTANCE hInstance, |
|
|
LPMALLOC lpMalloc, |
|
|
LPALLOCATEBUFFER lpAllocateBuffer, |
|
|
LPALLOCATEMORE lpAllocateMore, |
|
|
LPFREEBUFFER lpFreeBuffer, |
|
|
ULONG ulFlags, |
|
|
ULONG ulMAPIVer, |
|
|
ULONG FAR * lpulProviderVer, |
|
|
LPMSPROVIDER FAR * lppMSProvider |
|
|
); |
|
Parameters
hInstance
[in] The
instance of the message store provider s
dynamic-link library (DLL) that MAPI used when it linked.
lpMalloc
[in] Pointer
to a memory allocator object exposing the OLE IMalloc interface. The
message store provider may need to use this allocation method when working with
certain interfaces such as IStream.
lpAllocateBuffer
[in] Pointer
to the MAPIAllocateBuffer
function, to be used where required by MAPI to allocate memory.
lpAllocateMore
[in] Pointer
to the MAPIAllocateMore
function, to be used where required by MAPI to allocate additional memory.
lpFreeBuffer
[in] Pointer
to the MAPIFreeBuffer
function, to be used where required by MAPI to free memory.
ulFlags
[in] Bitmask
of flags. The following flag can be set:
MAPI_NT_SERVICE
The provider
is being loaded in the context of a Windows NT service, a special type of
process without access to any user interface.
ulMAPIVer
[in] Version
number of the service provider interface (SPI) that MAPI.DLL uses. For the
current version number, see the MAPISPI.H header file.
lpulProviderVer
[out] Pointer
to the version number of the SPI that this message store provider uses.
lppMSProvider
[out] Pointer
to a pointer to the initialized message store provider object.
Return Values
S_OK
The call
succeeded and has returned the expected value or values.
MAPI_E_VERSION
The SPI
version being used by MAPI is not compatible with the SPI being used by this
provider.
Remarks
MAPI calls
the entry point function MSProviderInit to initialize a message store
provider following a client logon.
Notes to Implementers
A message
store provider must implement MSProviderInit as an entry point function
in the provider s DLL. The implementation must be based on the MSPROVIDERINIT
function prototype, also specified in MAPISPI.H. MAPI defines MSPROVIDERINIT
to use the standard MAPI initialization call type, STDMAPIINITCALLTYPE, which
causes MSProviderInit to follow the CDECL calling convention. The
advantage of CDECL is that calls can be attempted even if the number of calling
parameters does not match the number of defined parameters.
A provider
can be initialized multiple times, as a result of appearing in several profiles
in simultaneous use or of appearing more than once in the same profile. MSProviderInit
must return a different provider object in lppMSProvider for each
initialization.
The provider
DLL should not be linked with MAPIX.DLL. Instead, it should use these pointers
for memory allocation or deallocation.
The message
store provider should use the functions pointed to by lpAllocateBuffer, lpAllocateMore,
and lpFreeBuffer for most memory allocation and deallocation. In
particular, the provider must use these functions to allocate memory for use by
client applications when calling object interfaces such as IMAPIProp::GetProps and IMAPITable::QueryRows. If the provider also
expects to use the OLE memory allocator, it should call the IUnknown::AddRef
method of the allocator object pointed to by the lpMalloc parameter.
For more information
on writing MSProviderInit, see Loading Message Store Providers. For more information on entry
point functions, see About Provider Entry Point Functions.
See Also