Platform SDK: Exchange Server

IExchangeFavorites::AddFavorites

The AddFavorites method adds one or more public folders to a user's Favorites folder.

HRESULT AddFavorites(
  LPENTRYLIST lpEntryList   
);
 

Parameters

lpEntryList
Input parameter. Points to a MAPI ENTRYLIST structure, which contains the list of public folders to add to the Favorites folder.

Return Values

See Return Values.

In addition, AddFavorites can return one of the following values:

SUCCESS_SUCCESS
The method completed successfully.
SYNC_E_INVALID_PARAMETER
One of the parameters (folders) was not valid.

Remarks

The AddFavorites method exits without processing the rest of the list and returns SYNC_E_INVALID_PARAMETER if one of the folders in the entry list is not a public folder that can be added to the user's Favorites folder.

See Also

IExchangeFavorites, IExchangeFavorites::DelFavorites