IMessage::CreateAttach
Область применения: Outlook 2013 | Outlook 2016
Создает новое вложение.
HRESULT CreateAttach(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulAttachmentNum,
LPATTACH FAR * lppAttach
);
Параметры
lpInterface
[в] Указатель на идентификатор интерфейса (IID), представляющий интерфейс, используемый для доступа к сообщению. Передача null приводит к возврату стандартного интерфейса сообщения или IMessage.
ulFlags
[в] Битовая маска флагов, управляющая способом создания вложения. Можно задать следующий флаг:
MAPI_DEFERRED_ERRORS
Позволяет команде CreateAttach успешно вернуться, возможно, до того, как вложение будет полностью доступно для вызывающего клиента. Если вложение недоступно, последующий вызов может привести к ошибке.
lpulAttachmentNum
[out] Указатель на номер индекса, определяющий только что созданное вложение. Это число допустимо, только если сообщение открыто и является основой для свойства PR_ATTACH_NUM (PidTagAttachNumber) вложения.
lppAttach
[out] Указатель на указатель на открытый объект вложения.
Возвращаемое значение
S_OK
Вложение успешно создано.
Замечания
Метод IMessage::CreateAttach создает новое вложение в сообщении. Новое вложение и все свойства, заданные для него, недоступны до тех пор, пока клиент не вызовет метод IMAPIProp::SaveChanges вложения и метод IMAPIProp::SaveChanges сообщения.
Номер вложения, на который указывает lpulAttachmentNum , уникален и действителен только в контексте сообщения. То есть два вложения в двух разных сообщениях могут иметь одинаковое число, а два вложения в одном сообщении — нет.