IMAPISupport::CopyMessages

適用対象: Outlook 2013 | Outlook 2016

1 つのフォルダーから別のフォルダーにメッセージをコピーまたは移動します。

HRESULT CopyMessages(
  LPCIID lpSrcInterface,
  LPVOID lpSrcFolder,
  LPENTRYLIST lpMsgList,
  LPCIID lpDestInterface,
  LPVOID lpDestFolder,
  ULONG_PTR ulUIParam,
  LPMAPIPROGRESS lpProgress,
  ULONG ulFlags
);

パラメーター

lpSrcInterface

[in]コピーまたは移動するメッセージを含むフォルダーへのアクセスに使用するインターフェイスを表すインターフェイス識別子 (IID) へのポインター。

lpSrcFolder

[in]コピーまたは移動するメッセージを含むフォルダーへのポインター。

lpMsgList

[in]コピーまたは移動するメッセージを識別するエントリ識別子の配列へのポインター。

lpDestInterface

[in]コピーまたは移動されたメッセージの宛先フォルダーへのアクセスに使用するインターフェイスを表すインターフェイス識別子 (IID) へのポインター。

lpDestFolder

[in]コピーまたは移動されたメッセージの宛先フォルダーへのポインター。 このフォルダーは開いている必要があります。

ulUIParam

[in]進行状況インジケーターを表示する進行状況オブジェクトへのポインター。 LPProgress で NULL が渡された場合、メッセージ ストア プロバイダーは MAPI 進行状況オブジェクトの実装を使用して進行状況インジケーターを表示します。 lpProgress パラメーターは、ulFlags でMESSAGE_DIALOG フラグが設定されていない限り無視されます。

lpProgress

[in]進行状況インジケーターを表示する進行状況オブジェクトへのポインター。 LPProgress で NULL が渡された場合、メッセージ ストア プロバイダーは MAPI 進行状況オブジェクトの実装を使用して進行状況インジケーターを表示します。 lpProgress パラメーターは、ulFlags でMESSAGE_DIALOG フラグが設定されていない限り無視されます。

ulFlags

[in]コピーまたは移動操作の実行方法を制御するフラグのビットマスク。 次のフラグを設定できます。

MESSAGE_DIALOG

進行状況インジケーターの表示を要求します。

MESSAGE_MOVE

メッセージは、コピーではなく移動する必要があります。 MESSAGE_MOVEが設定されていない場合は、メッセージがコピーされます。

戻り値

S_OK

コピー操作または移動操作が成功しました。

MAPI_E_USER_CANCEL

ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。

注釈

IMAPISupport::CopyMessages メソッドは、メッセージ ストア プロバイダーサポート オブジェクトに実装されています。 メッセージ ストア プロバイダーは、IMAPIFolder::CopyMessages の実装で IMAPISupport::CopyMessages を呼び出して、1 つまたは複数のメッセージを 1 つのフォルダーから別のフォルダーにコピーまたは移動できます。 IMAPISupport::CopyMessages 呼び出しの一環として、メッセージ ストア プロバイダーは MAPI に進行状況インジケーターを表示するように指定できます。

関連項目

IMAPIFolder::CopyMessages

IMAPISupport: IUnknown