Sm_AgentApi_ChangePassword()
ユーザのパスワードを変更します。結果として得られた属性およびセッション オブジェクトからの理由コードは、正しいパスワード サービス リダイレクトの作成に使用されます。
casso127jpjp
ユーザのパスワードを変更します。結果として得られた属性およびセッション オブジェクトからの理由コードは、正しいパスワード サービス リダイレクトの作成に使用されます。
構文
int SM_EXTERN Sm_AgentApi_ChangePassword (const void* pHandle,const char* lpszClientIpAddr,const char* lpszNewPassword,const char* pszTokenValue,const Sm_AgentApiResourceContext_t* pResourceContext,const Sm_AgentApi_Realm_t* pRealm,const Sm_AgentApi_UserCredentials_t* pUserCredentials,Sm_AgentApi_Session_t* pSession,long * numAttributes,Sm_AgentApi_Attribute_t** ppAttributes);
パラメータ | I/O | 説明 |
pHandle
| I | Sm_AgentApi_Init() の ppHandle パラメータで返されるエージェント API セッション ハンドル。 |
lpszClientIpAddr
| I | リソースを要求しているクライアントの IP アドレス。このパラメータは任意です。クライアント IP がアスタリスク(*)で始まる場合、ポリシー サーバはこの IP アドレスをログ記録しますが、セッション仕様に照らした検証は行いません。 |
lpszNewPassword
| I | ユーザが変更を予定している新しいパスワード(文字列)。 |
pszTokenValue
| I | パスワード サービス リダイレクトの場合にポリシー サーバと Web エージェントの間で交換されるトークン。(Sm_AgentApi_ChangePassword() によって返された) ppAttributes から抽出された SMTOKEN をポリシー サーバに送信する場合にこのパラメータを使用します。 pUserCredentials パラメータの nChallengeReason 値が Sm_Api_Reason_PWSelfChange(ユーザによって開始されたパスワード変更を示します)に設定されている場合、この値は Null の可能性があります。 |
pResourceContext
| I | リソース定義構造体へのポインタ。 |
pRealm
| I | レルム定義構造体。 |
pUserCredentials
| I | ユーザ認証情報定義構造体。 |
pSession
| O | ユーザ セッション定義構造体。 |
pNumAttributes
| O | ppAttributes 内の属性の数。 |
ppAttributes
| O | レスポンス属性定義構造体の配列へのポインタ。 |
戻り値
- SM_AGENTAPI_YES。ユーザ パスワードが変更されました。
- SM_AGENTAPI_NO。ユーザ パスワードは変更されませんでした。
- SM_AGENTAPI_NOCONNECTION。初期化できませんでした。
- SM_AGENTAPI_TIMEOUT。関数がタイム アウトしました。
- SM_AGENTAPI_FAILURE。パスワードは変更されませんでした。