IMAPISupport : IUnknown

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Provides implementations for tasks that are typically performed by service providers and message service entry point functions. Service providers receive a pointer to their support object when MAPI calls their provider object's logon method. Message services receive their support object pointer in the call to their entry point function.

Header file:	Mapispi.h
Exposed by:	Support objects
Implemented by:	MAPI
Called by:	Service providers
Interface identifier:	IID_IMAPISup
Pointer type:	LPMAPISUP

Vtable Order

GetLastError	Returns a MAPIERROR structure that contains information about the previous support object error.
GetMemAllocRoutines	Retrieves the addresses of the MAPI memory allocation and deallocation functions (MAPIAllocateBuffer, MAPIAllocateMore, and MAPIFreeBuffer).
Subscribe	Registers an advise sink to receive notifications through MAPI.
Unsubscribe	Cancels the responsibility for sending notifications that was previously established with a call to the Subscribe method.
Notify	Sends a notification of a specified event to an advise source that originally registered for the notification through the Subscribe method.
ModifyStatusRow	Modifies the status table by adding a new row or modifying an existing row.
OpenProfileSection	Opens a section of the current profile and returns an IProfSect pointer for further access
RegisterPreprocessor	Registers a transport provider's preprocessor function (a function that conforms to the PreprocessMessage prototype).
NewUID	Creates a new MAPIUID structure to be used as a unique identifier.
MakeInvalid	Marks an object as unusable.
SpoolerYield	Gives control of the CPU to the MAPI spooler so that it can perform any tasks it considers necessary.
SpoolerNotify	Notifies the MAPI spooler of a change in status or a request for service.
CreateOneOff	Creates an entry identifier for a one-off address.
SetProviderUID	Registers a MAPIUID structure that uniquely represents the service provider.
CompareEntryIDs	Compares two entry identifiers to determine whether they refer to the same object.
OpenTemplateID	Opens a recipient entry in a foreign address book provider.
OpenEntry	Opens an object and returns an interface pointer for further access.
GetOneOffTable	Returns a pointer to the MAPI one-off table (a list of templates that all address book providers support for creating new recipients).
Address	Displays the common address dialog box.
Details	Displays a dialog box that shows details about a particular address book entry.
NewEntry	Adds a new recipient directly to an address book container or to the recipient list of an outgoing message.
DoConfigPropsheet	Displays a configuration property sheet.
CopyMessages	Copies or moves messages from one folder to another folder.
CopyFolder	Copies or moves a folder from its current parent folder to another parent folder.
DoCopyTo	Copies or moves all properties of one object, except for specifically excluded properties, to another object.
DoCopyProps	Copies or moves one or more properties of an object to another object.
DoProgressDialog	Retrieves a progress object that displays a progress indicator.
ReadReceipt	Generates a read or nonread report for a message.
PrepareSubmit	Prepares a message for submission to the MAPI spooler.
ExpandRecips	Completes a message's recipient list, expanding particular distribution lists.
DoSentMail	Processes a sent message.
OpenAddressBook	Provides access to the address book.
CompleteMsg	Performs postprocessing on a message.
StoreLogoffTransports	Requests the orderly release of a message store.
StatusRecips	Generates delivery and nondelivery reports.
WrapStoreEntryID	Converts a message store's internal entry identifier to an entry identifier in the MAPI standard format.
ModifyProfile	Makes changes to a message store profile section permanent.
IStorageFromStream	Implements a storage object to access a stream.
GetSvcConfigSupportObj	Creates a message service support object.

Remarks

Address books, message stores, transport providers, and message services each have their own support objects. Service providers and message services call the methods in their support objects as part of their implementations of other interface methods. Each different support object has complete implementations of the methods that apply to its caller; the methods that are not applicable return MAPI_E_NO_SUPPORT. Address book provider support objects have implementations for the following methods:

Address	CompareEntryIDs	CreateOneOff
Details	DoConfigPropsheet	DoProgressDialog
GetLastError	GetMemAllocRoutines	GetOneOffTable
IStorageFromStream	GetSvcConfigSupportObj	MakeInvalid
ModifyStatusRow	NewEntry	NewUID
Notify	OpenAddressBook	OpenEntry
OpenProfileSection	OpenTemplateID	SetProviderUID
Subscribe	Unsubscribe	WrapStoreEntryID

Message store provider support objects have implementations for the following methods:

CompareEntryIDs	CompleteMsg	CopyFolder
CopyMessages	CreateOneOff	DoCopyProps
DoCopyTo	DoConfigPropsheet	DoProgressDialog
DoSentMail	ExpandRecips	GetLastError
GetMemAllocRoutines	GetSvcConfigSupportObj	MakeInvalid
IStorageFromStream	ModifyProfile	ModifyStatusRow
NewUID	Notify	OpenAddressBook
OpenEntry	OpenProfileSection	PrepareSubmit
ReadReceipt	SetProviderUID	SpoolerNotify
StoreLogoffTransports	Subscribe	Unsubscribe
WrapStoreEntryID

Transport provider support objects have implementations for the following methods:

DoConfigPropsheet	CompareEntryIDs	CreateOneOff
GetMemAllocRoutines	GetSvcConfigSupportObj	GetLastError
IStorageFromStream	MakeInvalid	ModifyStatusRow
OpenAddressBook	RegisterPreprocessor	NewUID
Notify	OpenProfileSection	OpenEntry
StatusRecips	SpoolerNotify	SpoolerYield
WrapStoreEntryID	Subscribe	Unsubscribe

Message service support objects have implementations for the following methods:

DoConfigPropsheet	GetLastError
GetMemAllocRoutines	GetSvcConfigSupportObj
MakeInvalid	NewUID
OpenProfileSection

See Also

Concepts

MAPI Interfaces