IMsgServiceAdmin : IUnknown
Applies to: Outlook 2013 | Outlook 2016
Makes changes to a message service in a profile.
| Property | Value |
|---|---|
| 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
| Member | Description |
|---|---|
| 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.