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。パスワードは変更されませんでした。