IMAPISupport::ModifyProfile

Last modified: July 23, 2011

Applies to: Outlook

Makes changes to a message store profile section permanent.

HRESULT ModifyProfile(
ULONG ulFlags
);

ulFlags

[in] A bitmask of flags that indicates the type of message store. The following flag can be set:

MDB_TEMPORARY

The message store is temporary and should not be added to the message store table. When MDB_TEMPORARY is set, ModifyProfile returns S_OK immediately.

S_OK

The changes to the profile section were successful.

The IMAPISupport::ModifyProfile method is implemented for message store provider support objects. Message store providers call ModifyProfile to prompt MAPI to modify their profile information.

ModifyProfile adds the profile section that is associated with the calling provider to the list of installed message store provider resources. This causes the message store to be listed in the message store table, which is available to clients through the IMAPISession::GetMsgStoresTable method, and to be opened without the display of a dialog box.

If the MDB_TEMPORARY flag is set, MAPI does nothing and the method returns immediately with S_OK.

Show: