IMsgServiceAdmin::CopyMsgService
適用対象: Outlook 2013 | Outlook 2016
メッセージ サービスをプロファイルにコピーします。
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
パラメーター
lpUID
[in]コピーするメッセージ サービスの一意識別子を含む MAPIUID 構造体へのポインター。
lpszDisplayName
[in]このパラメーターは非推奨になりました。
lpInterfaceToCopy
[in]コピーするメッセージ サービスのプロファイル セクションにアクセスするために使用するインターフェイスを表すインターフェイス識別子 (IID) へのポインター。 NULL を渡すと、標準プロファイル セクション インターフェイス IProfSect が使用されます。
lpInterfaceDst
[in] lpObjectDst パラメーターが指すオブジェクトにアクセスするために使用するインターフェイスを表す IID へのポインター。 NULL を渡すと、セッション インターフェイス IMAPISession が使用されます。 lpInterfaceDst パラメーターは、IID_IMsgServiceAdminに設定することもできます。
lpObjectDst
[in]セッションまたはメッセージ サービス管理オブジェクトへのポインター。 オブジェクトの型は、 lpInterfaceDst で渡されるインターフェイス識別子に対応する必要があります。 有効なオブジェクト ポインターは LPMAPISESSION および LPSERVICEADMIN です。
ulUIParam
[in]このメソッドが表示するダイアログ ボックスまたはウィンドウの親ウィンドウへのハンドル。
ulFlags
[in]メッセージ サービスのコピー方法を制御するフラグのビットマスク。 次のフラグを設定できます。
SERVICE_UI_ALWAYS
メッセージ サービスが常に構成プロパティ シートを表示することを要求します。
戻り値
S_OK
メッセージ サービスが正常にコピーされました。
MAPI_E_NO_ACCESS
メッセージ サービスは既にプロファイル内にあり、それ自体の複数のインスタンスを許可しません。
MAPI_E_NOT_FOUND
lpUID が指す MAPIUID は、既存のメッセージ サービスを参照しません。
注釈
IMsgServiceAdmin::CopyMsgService メソッドは、アクティブなプロファイルまたは別のプロファイルのプロファイルにメッセージ サービスをコピーします。 コピーするメッセージ サービスと宛先を含むプロファイルは同じプロファイルである必要はありませんが、同じプロファイルである必要はありません。
メッセージ サービスのエントリ ポイント関数は、コピー操作では呼び出されません。 コピーされたメッセージ サービスの構成設定は、元のメッセージ サービスと同じです。 これらの設定を変更するには、クライアントから IMsgServiceAdmin::ConfigureMsgService メソッドを呼び出す必要があります。