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

Статья
04/04/2023

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

Содержит список отображаемых имен получателей основного сообщения (To), разделенных точкой с запятой (;).

Свойство	Значение
Связанные свойства:	PR_DISPLAY_TO, PR_DISPLAY_TO_A, PR_DISPLAY_TO_W
Идентификатор:	0x0E04
Тип данных:	PT_STRING8, PT_UNICODE
Область:	Сообщение

Замечания

Хранилище сообщений вычисляет эти свойства для объектов сообщений с помощью метода IMessage::ModifyRecipients . Хранилище сообщений также поддерживает эти свойства, чтобы оно всегда отражало последнее сохраненное состояние сообщения. Значение синхронизируется во время каждого вызова метода IMAPIProp::SaveChanges .

Если в сообщении нет основных получателей, хранилище сообщений должно отвечать на вызов IMAPIProp::GetProps возвращаемым значением S_OK и пустой строкой для PR_DISPLAY_TO.

Из-за возможной необходимости локализации MAPI предоставляет следующие рекомендации для всех имен получателей:

Все имена должны быть локализованы.
Точка с запятой должна быть символом, который используется для разделения имен в свойствах PR_DISPLAY_BCC (PidTagDisplayBcc), PR_DISPLAY_CC (PidTagDisplayCc) и PR_DISPLAY_TO . Точки с запятой не допускаются в именах получателей в MAPI.
Клиенты должны перевести каждую точку с запятой, обнаруженную в PR_DISPLAY_TO и связанных свойств, в локализованный символ разделителя, прежде чем сделать информацию видимой в пользовательском интерфейсе.
При пересылке сообщений клиентам не нужно переводить символы разделителя в основной строке получателя.