Platform SDK: Exchange Server

IExchangeFavorites::DelFavorites

The DelFavorites method removes one or more folders from a user's Favorites folder.

HRESULT DelFavorites(
  LPENTRYLIST lpEntryList   
);
 

Parameters

lpEntryList
Input parameter. Points to a MAPI ENTRYLIST structure, which contains the list of folders to remove to the Favorites folder. Note that this list contains the entry identifiers of the folders in the Favorites folder, not the entry identifiers of the public folders.

Return Values

See Return Values.

In addition, DelFavorites 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 DelFavorites 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 folder that can be removed from the user's Favorites folder.

See Also

IExchangeFavorites, IExchangeFavorites::AddFavorites