IMAPITable::FreeBookmark Method

Frees a bookmark created by IMAPITable::CreateBookmark.

Syntax

HRESULT FreeBookmark(
    BOOKMARK bkPosition
);

Parameters

  • bkPosition
    BOOKMARK Value of type BOOKMARK that specifies the bookmark to be freed.

Return Value

HRESULT

The method can return one of the following values.

Return code Description
S_OK

The operation completed successfully.

MAPI_E_INVALID_BOOKMARK

The specified bookmark is invalid.

 

Remarks

A bookmark that has been freed is no longer valid, and consequently can no longer be used by the IMAPITable::SeekRow or IMAPITable::FindRow methods.

If the bookmark specified by the bkPosition parameter does not exist, the method returns MAPI_E_INVALID_BOOKMARK.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 4.0

Header

Wabdefs.h

DLL

Wab32.dll

See Also

IMAPITable

Reference

CreateBookmark

SeekRow

FindRow

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010