Поделиться через


IMAPITable::CreateBookmark

Область применения: Outlook 2013 | Outlook 2016

Создает закладку в текущей позиции таблицы.

HRESULT CreateBookmark(
BOOKMARK FAR * lpbkPosition
);

Параметры

lpbkPosition

[out] Указатель на возвращенное 32-разрядное значение закладки. Позже эту закладку можно передать в вызове метода IMAPITable::SeekRow .

Возвращаемое значение

S_OK

����� ������� � ������ ��������� ��������� ��� ��������.

MAPI_E_UNABLE_TO_COMPLETE

Не удалось выполнить запрошенную операцию.

Замечания

Метод IMAPITable::CreateBookmark помечает позицию таблицы путем создания значения с именем закладки. Закладка может использоваться для возврата в позицию, определяемую закладкой. Позиция закладки связана с объектом в этой строке таблицы.

Закладки не поддерживаются для таблиц вложений, а реализации таблиц вложений CreateBookmark возвращают MAPI_E_NO_SUPPORT.

Примечания для исполнителей

Из-за затрат на память при сохранении позиций курсора с закладками ограничьте количество закладок, которые можно создать. Когда вы достигнете этого номера, верните MAPI_E_UNABLE_TO_COMPLETE из всех последующих вызовов CreateBookmark.

Иногда закладка указывает на строку, которая больше не находится в представлении таблицы. Если вызывающий объект использует такую закладку, переместите курсор в следующую видимую строку и остановите там.

Когда вызывающий объект пытается использовать закладку, указывающую на невидимую строку, так как она была свернута, верните MAPI_W_POSITION_CHANGED после перемещения закладки. Вы можете переместить закладку в следующую видимую строку в это время или при сворачивании в методе SetCollapseState . При перемещении закладки во время сворачивания строки необходимо сохранить в закладке немного, который указывает, когда именно была перемещена закладка: с момента ее последнего использования или если она никогда не использовалась с момента ее создания.

Примечания для вызывающих методов

CreateBookmark выделяет память для создаваемой закладки. Освободите ресурсы для закладки, вызвав метод IMAPITable::FreeBookmark .

См. также

IMAPITable::FreeBookmark

IMAPITable::SeekRow

IMAPITable : IUnknown