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 所指向的附件編號是唯一的,而且只在訊息的內容中有效。 也就是說,兩個不同訊息中的兩個附件可以有相同的數位,而相同訊息中的兩個附件則無法。