Каноническое свойство PidTagRecordKey

Статья
04/04/2023

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

Содержит уникальный двоичный сопоставимый идентификатор для определенного объекта.

Свойство	Значение
Связанные свойства:	PR_RECORD_KEY
Идентификатор:	0x0FF9
Тип данных:	PT_BINARY
Область:	Свойства идентификатора

Замечания

Это свойство упрощает поиск ссылок на объект, например поиск его строки в таблице содержимого. Это свойство не может использоваться для открытия объекта; для этой цели используйте идентификатор записи.

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

Для папок это свойство содержит ключ, используемый в таблице иерархии папок. Обычно это то же значение, что и свойство PR_ENTRYID (PidTagEntryId).

Для хранилищ сообщений это свойство идентично свойству PR_STORE_RECORD_KEY (PidTagStoreRecordKey).

В объекте хранилища сообщений это свойство должно быть уникальным для всех поставщиков хранилища. Один из способов сделать это — объединить значение свойства PR_MDB_PROVIDER (PidTagStoreProvider) для хранилища (уникальное для этого типа поставщика) со структурой GUID или другим значением, уникальным для конкретного хранилища сообщений.

Это свойство всегда доступно с помощью метода IMAPIProp::GetProps после первого вызова метода IMAPIProp::SaveChanges . Некоторые поставщики могут сделать его доступным сразу после создания экземпляра.

Клиент или поставщик услуг может сравнивать значения из этого свойства с помощью memcmp. Это невозможно для входных значений идентификаторов. Однако это свойство гарантированно будет уникальным в одном хранилище сообщений или контейнере адресной книги. два объекта из разных контейнеров могут иметь одинаковое значение этого свойства.

Одно из различий между ключами записи и поиска заключается в том, что ключ записи относится к объекту, в то время как ключ поиска можно скопировать в другие объекты. Например, две копии объекта могут иметь одно и то же значение PR_SEARCH_KEY (PidTagSearchKey), но должны иметь разные значения для этого свойства.

В следующей таблице перечислены важные различия между PR_ENTRYID, PR_SEARCH_KEY (PidTagSearchKey) и этим свойством.

Характеристика	PR_ENTRYID	PR_RECORD_KEY	PR_SEARCH_KEY
Требуется для объектов вложений	Нет	Да	Нет
Требуется для объектов папки	Да	Да	Нет
Требуется для объектов хранилища сообщений	Да	Да	Нет
Требуется для объектов состояния	Да	Нет	Нет
Создание по клиенту	Нет	Нет	Да
Доступно до вызова SaveChanges	Может	Может	Сообщения Да, другие, возможно,
Изменение в операции копирования	Да	Да	Нет
Может быть изменено клиентом после копирования	Нет	Нет	Да
Уникальный внутри ...	Весь мир	Экземпляр поставщика	Весь мир
Двоичное сравнение (как и в memcmp)	Нет — используйте IMAPISupport:: CompareEntryIDs	Да	Да