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

Статья
04/04/2023

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

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

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

Замечания

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

MAPI использует определенные правила для создания ключей поиска для получателей сообщений. Ключ поиска формируется путем объединения типа адреса (в прописных буквах), символа двоеточия ":", адреса электронной почты в канонической форме и завершающего символа NULL. Каноническая форма здесь означает, что адреса с учетом регистра отображаются в правильном регистре, а адреса без учета регистра преобразуются в верхний регистр. Это важно для сохранения корреляций между сообщениями.

Для объектов message это свойство доступно с помощью метода IMAPIProp::GetProps сразу после создания сообщения. Для других объектов он доступен после первого вызова метода IMAPIProp::SaveChanges . Так как это свойство можно изменить, его невозможно получить с помощью GetProps до тех пор, пока вызов SaveChanges не зафиксирует любые значения, заданные или измененные методом IMAPIProps::SetProps .

Для профилей MAPI также предоставляет жестко закодированный раздел профиля с именем MUID_PROFILE_INSTANCE с этим свойством в качестве одного свойства. Этот ключ гарантированно будет уникальным среди всех когда-либо созданных профилей и может быть более надежным, чем свойство PR_PROFILE_NAME (PidTagProfileName), которое может быть удалено и повторно создано с тем же именем.

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

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