適用対象: Outlook 2013 | Outlook 2016
1 つ以上の受信者を 1 つのコンテナーから別のコンテナーまたは同じコンテナーにコピーするには、最初にターゲット コンテナーが変更可能であることをチェックします。 変更可能なコンテナーは、PR_CONTAINER_FLAGS (PidTagContainerFlags) プロパティのAB_MODIFIABLE フラグを設定します。
変更可能なコンテナーに 1 つ以上のエントリをコピーするには、変換先コンテナーの IABContainer::CopyEntries メソッドを呼び出します。 アドレス帳エントリのコピーには時間がかかる場合があるため、 CopyEntries は、コピーするエントリのエントリ識別子の配列、ウィンドウ ハンドル、進行状況インジケーター、フラグのビットマスクの 4 つの入力パラメーターを受け取ります。
ウィンドウ ハンドルと進行状況インジケーターは、ユーザーに操作の状態を表示するためにアドレス帳プロバイダーによって使用されます。 進行状況を表示する場合は、 ulUIParam パラメーターで進行状況インジケーターの親ウィンドウのウィンドウ ハンドルを渡し、 ulFlags パラメーターでAB_NO_DIALOG フラグを設定しないでください。 進行状況インジケーターの独自の実装がある場合は、 lpProgress パラメーターの実装へのポインターを渡します。 そうでない場合は、NULL を渡します。 アドレス帳プロバイダーは、MAPI 進行状況インジケーターの実装を使用します。
フラグのビットマスクは、進行状況インジケーターを表示するかどうかと、重複するエントリ チェックを処理する方法を示します。 進行状況インジケーターを抑制するには、AB_NO_DIALOG フラグを設定します。 CREATE_CHECK_DUP_LOOSE フラグを設定して、重複を疎にチェックするようにアドレス帳プロバイダーに指示するか、重複チェックを厳格にするためにCREATE_CHECK_DUP_STRICTフラグを設定します。 プロバイダーが重複があると判断したときに、既存のエントリを置き換えるエントリをコピーするようにCREATE_REPLACE フラグを設定します。
個人用アドレス帳 (PAB) コンテナーにコピーする場合、プロバイダーは各エントリのプロパティの一部またはすべてをコピーします。 MAPI ではコンテナー コピー操作を実装するプロバイダーの要件が確立されないため、アドレス帳エントリでコピーされるプロパティの数と種類を想定することはできません。