IMsgServiceAdmin : 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.

Makes changes to a message service in a profile.

Header file:

MapiX.h

Exposed by:

Message service administration objects

Implemented by:

MAPI

Called by:

Client applications

Interface identifier:

IID_IMsgServiceAdmin

Pointer type:

LPSERVICEADMIN

Vtable Order

GetLastError

Returns a MAPIERROR structure that contains information about the last error generated by a message service administration object.

GetMsgServiceTable

Provides access to the message service table, a list of the message services in the profile.

CreateMsgService

Adds a message service to the current profile.

DeleteMsgService

Deletes a message service from a profile.

CopyMsgService

Copies a message service into a profile.

RenameMsgService

Deprecated. Assigns a new name to a message service.

ConfigureMsgService

Reconfigures a message service.

OpenProfileSection

Opens a section of the current profile and returns an IProfSect pointer for further access.

MsgServiceTransportOrder

Sets the order in which transport providers are called to deliver a message.

AdminProviders

Returns a pointer that provides access to a provider administration object.

SetPrimaryIdentity

Designates a message service to be the supplier of the primary identity for the profile.

GetProviderTable

Provides access to the provider table, a listing of the service providers in the profile.

Remarks

An implementation can get a pointer to an IMsgServiceAdmin interface in two ways: by calling the IMAPISession::AdminServices method or by calling the IProfAdmin::AdminServices method. For clients primarily concerned with profile configuration, IProfAdmin::AdminServices is the preferred way to get the IMsgServiceAdmin interface, because it does not log on providers to the MAPI session. If a client requires the ability to make changes to the active profile, then IMAPISession::AdminServices should be called to get the IMsgServiceAdmin pointer. Be aware that although MAPI does not allow a profile that is in use to be deleted, there are no safeguards to prevent a client from removing all the message services in the profile.

See Also

Concepts

MAPI Interfaces