This documentation is archived and is not being maintained.

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:


Exposed by:

Message service administration objects

Implemented by:


Called by:

Client applications

Interface identifier:


Pointer type:



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


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


Adds a message service to the current profile.


Deletes a message service from a profile.


Copies a message service into a profile.


Deprecated. Assigns a new name to a message service.


Reconfigures a message service.


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


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


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


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


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

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.