IMAPITable::FreeBookmark
Applies to: Outlook 2013 | Outlook 2016
Releases the memory associated with a bookmark.
HRESULT FreeBookmark(
BOOKMARK bkPosition
);
Parameters
bkPosition
[in] The bookmark to be freed, created by calling the IMAPITable::CreateBookmark method.
Return value
S_OK
The bookmark was successfully freed.
MAPI_E_INVALID_BOOKMARK
The specified bookmark does not exist.
Remarks
The IMAPITable::FreeBookmark method releases a bookmark that is no longer needed. The bookmark is no longer valid after this call. Whenever a table is released from memory, all of its associated bookmarks are also released.
Notes to implementers
If the caller passes one of the three predefined bookmarks in the bkPosition parameter, ignore the request and return S_OK.