IMAPITable::CreateBookmark Method

Article
06/30/2010

Marks the current position of the table cursor.

Syntax

HRESULT CreateBookmark(
    BOOKMARK *lpbkPosition
);

Parameters

lpbkPosition
BOOKMARK Pointer to a variable of type BOOKMARK that receives the bookmark value.

Return Value

HRESULT

The method can return one of the following values.

Return code	Description
S_OK	The operation completed successfully.
MAPI_E_UNABLE_TO_COMPLETE	The requested operation could not be completed.

Remarks

Return to the bookmarked position by means of the IMAPITable::SeekRow method, or specify the bookmark as the starting point of a IMAPITable::FindRow table search. The position identified can be retrieved from the bookmark even after the table has been updated.

When the bookmark is no longer needed, clean up by freeing it with the IMAPITable::FreeBookmark method.

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 4.0
Header	Wabdefs.h
DLL	Wab32.dll

Share via