IMessage::CreateAttach
适用于:Outlook 2013 | Outlook 2016
创建新附件。
HRESULT CreateAttach(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulAttachmentNum,
LPATTACH FAR * lppAttach
);
参数
lpInterface
[in]指向接口标识符的指针 (IID) 表示要用于访问消息的接口。 传递 NULL 会导致返回消息的标准接口(即 IMessage)。
ulFlags
[in]控制附件创建方式的标志的位掩码。 可以设置以下标志:
MAPI_DEFERRED_ERRORS
允许 CreateAttach 成功返回,可能是在调用客户端完全可访问附件之前。 如果附件不可访问,则对附件进行后续调用可能会导致错误。
lpulAttachmentNum
[out]指向标识新创建的附件的索引号的指针。 此数字仅在邮件打开时有效,并且是附件 PR_ATTACH_NUM (PidTagAttachNumber) 属性的基础。
lppAttach
[out]指向指向打开的附件对象的指针的指针。
返回值
S_OK
已成功创建附件。
备注
IMessage::CreateAttach 方法在邮件上创建新的附件。 在客户端调用附件的 IMAPIProp::SaveChanges 方法和消息的 IMAPIProp::SaveChanges 方法之前,新附件和为其设置的任何属性都不可用。
lpulAttachmentNum 指向的附件编号是唯一的,仅在邮件上下文中有效。 也就是说,两封不同邮件中的两个附件可以具有相同编号,而同一邮件中的两个附件不能。