IMAPISupport::CreateOneOff

Статья
04/04/2023

Область применения: 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 или X500) получателя. Параметр 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

Идентификатор однократной записи успешно создан.

Замечания

Метод IMAPISupport::CreateOneOff реализован для всех объектов поддержки поставщика услуг. Поставщики услуг вызывают CreateOneOff , чтобы создать идентификатор записи для однократного получателя (получателя, который не принадлежит ни одному из контейнеров ни одного из загруженных поставщиков адресных книг).

Примечания для вызывающих методов

По завершении использования идентификатора записи, возвращенного командой CreateOneOff, освободите память, выделенную для идентификатора записи, с помощью функции MAPIFreeBuffer .

Примечания к поставщикам транспорта

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

См. также

MAPIFreeBuffer

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

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

IMAPISupport: IUnknown

Поделиться через