IMAPITable::FreeBookmark
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.
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.