IMsgServiceAdmin : IUnknown

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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.

Note

This method is deprecated. Use IMsgServiceAdmin2::CreateMsgServiceEx instead.

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