IProfAdmin::CopyProfile
適用対象: Outlook 2013 | Outlook 2016
プロファイルをコピーします。
HRESULTCopyProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
パラメーター
lpszOldProfileName
[in]コピーするプロファイルの名前へのポインター。
lpszOldPassword
[in]コピーするプロファイルのパスワードへのポインター。
lpszNewProfileName
[in]コピーしたプロファイルの新しい名前へのポインター。
ulUIParam
[in]このメソッドが表示するダイアログ ボックスまたはウィンドウの親ウィンドウへのハンドル。
ulFlags
[in]プロファイルのコピー方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_DIALOG
コピーするプロファイルの正しいパスワードをユーザーに求めるダイアログ ボックスを表示します。 このフラグが設定されていない場合、ダイアログ ボックスは表示されません。
戻り値
S_OK
プロファイルが正常にコピーされました。
MAPI_E_ACCESS_DENIED
新しいプロファイル名は、既存のプロファイルの名前と同じです。
MAPI_E_LOGON_FAILED
コピーするプロファイルのパスワードが正しくなく、 ulFlags パラメーターにMAPI_DIALOGが設定されていないため、ユーザーに正しいパスワードを要求するダイアログ ボックスを表示できませんでした。
MAPI_E_NOT_FOUND
指定したプロファイルが存在しません。
MAPI_E_USER_CANCEL
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。
注釈
IProfAdmin::CopyProfile メソッドは、lpszOldProfileName が指すプロファイルのコピーを作成し、lpszNewProfileName が指す名前を指定します。 プロファイルをコピーすると、コピーは元のパスワードと同じになります。
元のプロファイルの名前、パスワード、およびコピーの長さは最大 64 文字で、次の文字を含めることができます。
- アクセント文字とアンダースコア文字を含むすべての英数字。
- 埋め込みスペースですが、先頭または末尾のスペースではありません。
プロファイル パスワードは、すべてのオペレーティング システムでサポートされているわけではありません。 プロファイル パスワードをサポートしていないオペレーティング システムでは、 lpszOldPassword は NULL または長さ 0 の文字列へのポインターにすることができます。
lpszOldPassword が NULL に設定されている場合、コピーするプロファイルにはパスワードが必要で、MAPI_DIALOG フラグが設定されます。パスワードの入力を求めるダイアログ ボックスが表示されます。 パスワードが必要ですが、 lpszOldPassword が NULL に設定され、MAPI_DIALOG フラグが設定されていない場合、 CopyProfile はMAPI_E_LOGON_FAILEDを返します。