SOAP API 開発者ガイド
jsetPassword()
構文
1SetPasswordResult setPasswordResult = connection.setPassword(ID userID, string password);使用方法
User または SelfServiceUser のパスワードを指定の値に変更するには、setPassword() を使用します。たとえば、クライアントアプリケーションは、ユーザに異なるパスワードを指定するように求め、ユーザのパスワード変更のために setPassword() を呼び出す可能性があります。API によって生成されたランダム値にパスワードをリセットする場合は、代わりに、resetPassword() を使用してください。
クライアントアプリケーションは、そのユーザのパスワードを変更するために必要なアクセス権限でログインされている必要があります。詳細は、「データアクセスに影響する要素」を参照してください。
ID についての詳細は、「ID データ型」を参照してください。
パスワードが失効していた場合、このコールは、LoginResult 内で返されるセッション ID を使用可能です。詳細は、「passwordExpired」 を参照してください。
サンプルコード —Java
このサンプルでは、ユーザ ID およびパスワードパラメータを受け取り、これらを使用して指定されたユーザのパスワードを設定する setPassword() コールを実行します。
1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public void doSetPassword(String userId, String newPasswd) {
18 try {
19 SetPasswordResult result = connection.setPassword(userId, newPasswd);
20 System.out.println("The password for user ID " + userId + " changed to "
21 + newPasswd);
22 } catch (ConnectionException ce) {
23 ce.printStackTrace();
24 }
25}サンプルコード —C#
このサンプルでは、ユーザ ID およびパスワードパラメータを受け取り、これらを使用して指定されたユーザのパスワードを設定する setPassword() コールを実行します。
1swfobject.registerObject("clippy.codeblock-2", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public void doSetPassword(String userId, String newPasswd)
18{
19 try
20 {
21 SetPasswordResult result = binding.setPassword(userId, newPasswd);
22 Console.WriteLine("The password for user ID " + userId + " changed to "
23 + newPasswd);
24 }
25 catch (SoapException e)
26 {
27 Console.WriteLine("An unexpected error has occurred: " +
28 e.Message + "\n" + e.StackTrace);
29 }
30}引数
| 名前 | 型 | 説明 |
|---|---|---|
| userID | ID | パスワードをリセットする User または SelfServiceUser の ID。ID についての詳細は、「ID データ型」を参照してください。 |
| password | string | 指定されたユーザのために使用される新しいパスワード。 |
応答
なし。