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

ITableData : IUnknown

  • Статья

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

Предоставляет служебные методы для работы с таблицами. MAPI предоставляет объекты табличных данных или объекты, реализующие ITableData , чтобы помочь поставщикам служб выполнять обслуживание таблиц. Чтобы получить объект данных таблицы, поставщики услуг вызывают функцию CreateTable .

Свойство Значение
Файл заголовка:
 Mapiutil.h
Предоставляется:
 Объекты данных таблицы
Реализовано в:
 MAPI
Вызывающая сторона:
 Поставщики служб
Идентификатор интерфейса:
 IID_IMAPITableData
Тип указателя:
 LPTABLEDATA

Порядок vtable

Member Описание
HrGetView
Создает табличное представление, возвращая указатель на реализацию IMAPITable .
HrModifyRow
Вставляет новую строку таблицы, возможно, заменив существующую строку.
HrDeleteRow
Удаляет строку таблицы.
HrQueryRow
Извлекает строку таблицы.
HrEnumRow
Извлекает строку на основе ее положения в таблице.
HrNotify
Отправляет уведомление для строки таблицы.
HrInsertRow
Вставляет строку таблицы.
HrModifyRows
Вставляет несколько строк таблицы, возможно, заменяя существующие строки.
HrDeleteRows
Удаляет несколько строк таблицы.

Замечания

Реализация MAPI ITableData работает с таблицами, удерживая все данные и связанные с ними ограничения в памяти, что делает ее непригодной для использования с очень большими таблицами. Большие ограничения и сложные операции, такие как классификация, не поддерживаются.

Объекты данных таблицы идентифицируют строки с помощью столбца индекса, свойства, которое гарантированно имеет уникальное значение для каждой строки. Большинство поставщиков услуг используют свойство PR_INSTANCE_KEY (PidTagInstanceKey) в качестве столбца индекса. Свойства с несколькими значениями нельзя использовать в качестве столбца индекса.

Объекты данных таблицы создают одно уведомление независимо от количества строк, затронутых изменением или удалением. Если целевая строка в операции не существует, добавляется строка.

См. также

Интерфейсы MAPI