IProfAdmin::RenameProfile
適用対象: Outlook 2013 | Outlook 2016
プロファイルに新しい名前を割り当てます。
HRESULT RenameProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
パラメーター
lpszOldProfileName
[in]名前を変更するプロファイルの現在の名前へのポインター。
lpszOldPassword
[in]Always NULL。
lpszNewProfileName
[in]名前を変更するプロファイルの新しい名前へのポインター。
ulUIParam
[in]このメソッドが表示するダイアログ ボックスまたはウィンドウの親ウィンドウへのハンドル。
ulFlags
[in]プロファイルの名前を変更する方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_APP_PROFILE
"アプリ" プロファイルの名前を変更できます。 プロファイルが "アプリ" プロファイルの場合は、このフラグを設定する必要があります。
このフラグは、すべての MAPI 実装で認識またはサポートされていない可能性があります。
戻り値
S_OK
プロファイルの名前が正常に変更されました。
MAPI_E_LOGON_FAILED
プロファイル パスワードが正しくありません。
MAPI_E_NO_ACCESS
プロファイルは "アプリ" プロファイルであり、MAPI_APP_PROFILE フラグが設定されていません。
MAPI_E_USER_CANCEL
ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。
解説
IProfAdmin::RenameProfile メソッドを使用すると、プロファイルに新しい名前が割り当てられます (プロファイルがある場合)。 RenameProfile が呼び出されたときに名前を変更するプロファイルがクライアントによって使用されている場合、RenameProfile はプロファイルをマークし、プロファイルの使用中に名前変更操作を試行する代わりにS_OKを返します。 プロファイルが使用されなくなったら、 RenameProfile によって新しい名前が割り当てられます。
プロファイルの古い名前と新しい名前の長さは最大 64 文字で、次の文字を含めることができます。
アクセント文字とアンダースコア文字を含むすべての英数字。
埋め込みスペースですが、先頭または末尾のスペースではありません。
lpszPassword は常に NULL または長さ 0 の文字列へのポインターである必要があります。