Каноническое свойство PidTagInstanceKey
Область применения: Outlook 2013 | Outlook 2016
Содержит значение, уникально определяющее строку в таблице.
| Свойство | Значение |
|---|---|
| Связанные свойства: |
PR_INSTANCE_KEY |
| Идентификатор: |
0x0FF6 |
| Тип данных: |
PT_BINARY |
| Область: |
Таблица |
Замечания
Это свойство является двоичным значением, уникальным образом определяющим строку в табличном представлении. Это обязательный столбец в большинстве таблиц. Если строка включена в два представления, есть два разных ключа экземпляра. Ключ экземпляра строки может отличаться при каждом открытии таблицы, но остается постоянным, пока таблица открыта. Строки, добавляемые во время использования таблицы, не используют ранее использованный ключ экземпляра.
Используйте свойства PR_ENTRYID (PidTagEntryId) или PR_RECORD_KEY (PidTagRecordKey), чтобы сопоставить все строки расширения. Используйте PR_INSTANCE_KEY , чтобы найти конкретный экземпляр в расширении.
При развертывании многозначного свойства в таблице создается строка для каждого экземпляра расширения, то есть для каждого значения этого свойства. Каждая строка имеет уникальное значение для свойства PR_INSTANCE_KEY , в то время как все остальные столбцы сохраняют свои исходные значения на протяжении всего расширения.
В классифицированном виде таблицы к результату сортировки можно добавить строки, не соответствующие фактическим данным. Каждая такая строка, как и все строки во всех таблицах, имеет собственный уникальный ключ экземпляра.
PR_INSTANCE_KEY также используется в уведомлениях о событиях таблицы. Члены propIndex и propPrior структуры TABLE_NOTIFICATION являются структурами SPropValue , в которых PR_INSTANCE_KEY значения. Элемент propIndex указывает на добавленную или измененную строку. Элемент propPrior указывает строку перед добавленной или измененной строкой (PR_NULL указывает на изменение первой строки).
Это значение не копируется как часть отображаемой таблицы.
PR_INSTANCE_KEY — это структура MAPIUID . Все ключи экземпляра можно напрямую сравнивать как двоичные значения.
Связанные ресурсы
Спецификации протокола
Содержит ссылки на связанные спецификации протоколов Exchange Server.
Задает свойства и операции для списков пользователей, контактов, групп и ресурсов.
Файлы заголовков
Mapidefs.h
Предоставляет определения типов данных.
Mapitags.h
Содержит определения свойств, перечисленных как альтернативные имена.