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 が指す添付ファイル番号は一意であり、メッセージのコンテキスト内でのみ有効です。 つまり、2 つの異なるメッセージ内の 2 つの添付ファイルは同じ番号を持つことができますが、同じメッセージ内の 2 つの添付ファイルは使用できません。