resetPassword()

構文

1string password = connection.resetPassword(ID userID);

使用方法

resetPassword() は、API で User または SelfServiceUser のパスワード変更し、ランダムな文字と数字から成るシステムが生成したパスワードを取得する場合に使用します。特定の値にパスワードを設定する場合は、setPassword() を使用します。

クライアントアプリケーションは、そのユーザのパスワードを変更するために必要なアクセス権限でログインされている必要があります。詳細は、「データアクセスに影響する要素」を参照してください。

ID についての詳細は、「ID データ型」を参照してください。

サンプルコード —Java

このサンプルでは、userId パラメータで指定されたユーザのパスワードをリセットします。この ID を使用して resetPassword() をコールし、コールの結果から仮のパスワードを取得します。この仮のパスワードをコンソールに書き込み、そのパスワードを返します。

1public String doResetPassword(String userId) {
2   String result = "";
3   try {
4      ResetPasswordResult rpr = connection.resetPassword(userId);
5      result = rpr.getPassword();
6      System.out.println("The temporary password for user ID " + userId
7            + " is " + result);
8   } catch (ConnectionException ce) {
9      ce.printStackTrace();
10   }
11   return result;
12}

サンプルコード —C#

このサンプルでは、userId パラメータで指定されたユーザのパスワードをリセットします。この ID を使用して resetPassword() をコールし、コールの結果から仮のパスワードを取得します。この仮のパスワードをコンソールに書き込み、そのパスワードを返します。

1public String doResetPassword(String userId)
2{
3   String result = "";
4   try
5   {
6      ResetPasswordResult rpr = binding.resetPassword(userId);
7      result = rpr.password;
8      Console.WriteLine("The temporary password for user ID " + userId + " is " +
9            result);
10   }
11   catch (SoapException e)
12   {
13      Console.WriteLine("An unexpected error has occurred: " +
14                        e.Message + "\n" + e.StackTrace);
15   }
16   return result;
17}

引数

応答

障害

InvalidIdFault

UnexpectedErrorFault