IMAPISupport::ModifyProfile

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 store profile section permanent.

HRESULT ModifyProfile(
ULONG ulFlags
);

Parameters

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

Return Value

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

See Also

Reference

IMAPISession::GetMsgStoresTable

IMAPISupport : IUnknown