IMAPISupport::ModifyProfile

The IMAPISupport::ModifyProfile method makes changes to a message store profile section permanent.

Quick Info

See IMAPISupport : IUnknown.

HRESULT ModifyProfile(
  ULONG ulFlags  
);
 

Parameters

ulFlags
[in] 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.

Return Values

S_OK
The changes to the profile section were successful.

Remarks

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 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, 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.

See Also

IMAPISession::GetMsgStoresTable