IAddrBook::CreateOneOff
Область применения: Outlook 2013 | Outlook 2016
Создает идентификатор записи для однократного адреса.
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Параметры
lpszName
[в] Указатель на значение свойства PR_DISPLAY_NAME получателя (PidTagDisplayName). Параметр lpszName может иметь значение NULL.
lpszAdrType
[в] Указатель на тип адреса получателя, например FAX или SMTP. Параметр lpszAdrType не может иметь значение NULL.
lpszAddress
[в] Указатель на адрес получателя. Параметр lpszAddress не может иметь значение NULL.
ulFlags
[в] Битовая маска флагов, которая влияет на единовременного получателя. Можно задать следующие флаги:
MAPI_SEND_NO_RICH_INFO
Получатель не может обрабатывать форматированный контент сообщения. Если задано MAPI_SEND_NO_RICH_INFO, MAPI задает для свойства PR_SEND_RICH_INFO получателя (PidTagSendRichInfo) значение FALSE. Если MAPI_SEND_NO_RICH_INFO не задано, MAPI устанавливает для этого свойства значение TRUE, если адрес для сообщений получателя, на который указывает lpszAddress , не интерпретируется как интернет-адрес. В этом случае MAPI задает для PR_SEND_RICH_INFO значение FALSE.
MAPI_UNICODE
Отображаемое имя, тип адреса и адрес имеют формат Юникода. Если флаг MAPI_UNICODE не задан, эти строки имеют формат ANSI.
lpcbEntryID
[out] Указатель на число байтов в идентификаторе записи, на который указывает параметр lppEntryID .
lppEntryID
[out] Указатель на указатель на идентификатор записи для однократного получателя.
Возвращаемое значение
S_OK
Идентификатор однократной записи успешно создан.
Замечания
Клиенты вызывают метод CreateOneOff , чтобы создать идентификатор записи для однократного получателя — получателя, который не принадлежит ни одному из контейнеров ни одного из загруженных поставщиков адресной книги. Однократные получатели могут иметь любой адрес, поддерживаемый одним из активных поставщиков адресных книг для сеанса.
Как правило, одноразовые получатели создаются с помощью шаблона для определенного типа адреса. Поставщик адресной книги, поддерживающий тип адреса, предоставляет шаблон. Пользователь клиентского приложения вводит соответствующие сведения в шаблон.
MAPI поддерживает символьные строки Юникода для отображаемого имени, типа адреса и параметров адреса CreateOneOff.
Флаг MAPI_SEND_NO_RICH_INFO определяет, отправляется ли форматированный текст в формате RTF вместе с каждым сообщением. Формат TNEF, используемый для передачи форматированного текста, отправляется большинством поставщиков транспорта независимо от того, как получатель задает свое свойство PR_SEND_RICH_INFO . Это не проблема для клиентов обмена сообщениями, которые работают с межличностными сообщениями. Однако, поскольку TNEF обычно используется для отправки настраиваемых свойств для пользовательских классов сообщений, отсутствие поддержки может быть проблемой для клиентов на основе форм или клиентов, которым требуются настраиваемые свойства MAPI. Дополнительные сведения см. в разделе Отправка сообщений с помощью TNEF.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI использует метод CreateOneOff для создания идентификатора записи для адреса, который не найден ни в одной адресной книге. |