Получение данных из строк таблицы
Область применения: Outlook 2013 | Outlook 2016
Получение строк из таблицы включает следующее:
Получение значений свойств для всех столбцов.
Изменение текущей позиции.
Одним из обязательных столбцов в большинстве таблиц является идентификатор записи — свойство PR_ENTRYID (PidTagEntryId), которое можно использовать для открытия объекта, представляющего строку. Этот идентификатор записи обычно является краткосрочным идентификатором записи, который не сохраняется после времени существования таблицы. Однако он может быть долгосрочным идентификатором, если поставщик услуг, реализующий таблицу, поддерживает только один тип идентификатора записи.
Клиенты и поставщики услуг могут выполнять один из следующих вызовов для получения строк:
| Звонок | Описание |
|---|---|
|
IMAPITable::QueryRows |
Извлекает указанное число строк, начиная с текущей строки в направлении вперед или назад. |
|
HrQueryAllRows |
Извлекает все строки в таблице. |
|
ITableData::HrQueryRow |
Извлекает строку в таблице в соответствии со значением столбца индекса. PR_INSTANCE_KEY (PidTagInstanceKey) обычно является столбцом индекса для таблицы. |
Если дополнительное свойство включается в качестве одного из столбцов в таблице, некоторые строки могут иметь допустимые значения для столбца, а другие — нет. Существует ли допустимое значение для столбца, зависит от того, задает ли объект, предоставляющий сведения для строки, свойство . В зависимости от реализации объекта несуществующее свойство может быть представлено в таблице как PR_NULL (PidTagNull) или произвольное значение. Пользователи таблиц должны быть осторожны, чтобы различать свойства, которые не существуют и имеют бессмысленные значения и свойства, которые существуют и имеют допустимые значения.