IProfAdmin::RenameProfileIProfAdmin::RenameProfile

適用されます: OutlookApplies to: Outlook

プロファイルに新しい名前が割り当てられます。Assigns a new name to a profile.

HRESULT RenameProfile(
  LPSTR lpszOldProfileName,
  LPSTR lpszOldPassword,
  LPSTR lpszNewProfileName,
  ULONG_PTR ulUIParam,
  ULONG ulFlags
);

ParametersParameters

lpszOldProfileNamelpszOldProfileName

[in]名前を変更するプロファイルの現在の名前へのポインター。[in] A pointer to the current name of the profile to rename.

lpszOldPasswordlpszOldPassword

[in]常に NULL を返します。[in] Always NULL.

lpszNewProfileNamelpszNewProfileName

[in]名前を変更するプロファイルの新しい名前へのポインター。[in] A pointer to the new name of the profile to rename.

ulUIParamulUIParam

[in]すべてのダイアログ ボックスの親ウィンドウまたはこのメソッドを表示するウィンドウへのハンドル。[in] A handle to the parent window of any dialog boxes or windows that this method displays.

ulFlagsulFlags

[in]常に NULL を返します。[in] Always NULL.

�߂�lReturn value

S_OKS_OK

プロファイルが変更されました。The profile was successfully renamed.

MAPI_E_LOGON_FAILEDMAPI_E_LOGON_FAILED

プロファイルのパスワードが正しくないです。The profile password is incorrect.

MAPI_E_USER_CANCELMAPI_E_USER_CANCEL

ユーザー操作がキャンセルされました、通常ダイアログ ボックスで [キャンセル] ボタンをクリックするとします。The user canceled the operation, typically by clicking the Cancel button in a dialog box.

備考Remarks

IProfAdmin::RenameProfileメソッドは、1 つがある場合、プロファイルに新しい名前を割り当てます。The IProfAdmin::RenameProfile method assigns a new name to a profile, if it has one. 名前を変更するプロファイルがクライアントによる使用の場合、 RenameProfileが呼び出されたときに、 RenameProfileは、プロファイルをマークし、プロファイルを使用している間は、名前の変更操作を試みたのではなく、S_OK を返します。If the profile to rename is in use by a client when RenameProfile is called, RenameProfile marks the profile and returns S_OK instead of attempting the rename operation while the profile is in use. プロファイルが使用されていないと、 RenameProfileによって新しい名前が割り当てられます。When the profile is no longer being used, RenameProfile assigns it the new name.

古いものと新しいプロファイルの名前は 64 文字以内であることができ、次の文字を含めることができます。The old and new names of the profile can be up to 64 characters in length and can include the following characters:

  • すべての英数字文字、アクセント記号付き文字およびアンダー スコア文字を含みます。All alphanumeric characters, including accent characters and the underscore character.

  • 埋め込みスペースがいない先頭または末尾のスペース。Embedded spaces, but not leading or trailing spaces.

_LpszPassword_は NULL または長さ 0 の文字列へのポインターに常にあります。The lpszPassword should always be NULL or a pointer to a zero-length string.

関連項目See also

IProfAdmin: IUnknownIProfAdmin : IUnknown