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 .