Sm_PolicyApi_SetUserPasswordState()
UserPasswordState オブジェクトを追加または更新します。
casso1283
UserPasswordState オブジェクトを追加または更新します。
ユーザと関連付けられた PasswordState がなければ、新しい PasswordState が作成されます。そうでないと、UserPasswordState が更新されます。
Type
パスワード状態関数。
構文
int SM_EXTERN Sm_PolicyApi_SetUserPasswordState (void*pSessionHandle,const char*pszUserDirOid,const char*pszUserDN,Sm_PolicyApi_UserPasswordState_t*pPasswordStatebool bEmptyHistory);
パラメータ | I/O | 説明 |
pSessionHandle | I | 内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。 |
pszUserDirOid | I | 特定のユーザ ディレクトリに相当する一意のオブジェクト識別子。 |
pszUserDN | I | ユーザ ディレクトリ内のユーザの識別名を指定します。 |
pPasswordState | I/O | ユーザ パスワード状態オブジェクト。 パスワードが最後に変更された日時に関するユーザ ディレクトリ設定がこのパラメータによって変更され、かつパスワードが SiteMinder の外部でリセットされた場合は、パスワード再利用を防ぐパスワード ポリシーが予期したとおりには機能しないことがあります。このパラメータが NULL に設定される場合、関数は Sm_PolicyApi_Failure を返します。 |
bEmptyHistory | I | この関数が既存のパスワード履歴をクリアするべきかどうかを指定します。このパラメータが真に設定される場合、構造 Sm_PolicyApi_UserPasswordState_t のフィールド tLastPWChange フィールドは暗黙的にゼロにリセットされます。 |
戻り値
- Sm_PolicyApi_Success。取得の操作が成功しました。
- Sm_PolicyApi_Failure。一般的な障害です。
- Sm_PolicyApi_InvalidHandle。セッション ポインタが無効です。
- Sm_PolicyApi_BadArgument。入力パスワード状態ポインタは NULL です。
- Sm_PolicyApi_NoSession。API ユーザが正しくログインしていません。
- Sm_PolicyApi_InvalidOid。一意の ID はユーザ ディレクトリ オブジェクトに相当しません。
- Sm_PolicyApi_UserDirNotFound。ポリシー ストアからのユーザ ディレクトリ オブジェクトの取得が失敗しました。
- Sm_PolicyApi_ErrorUserDir。無効なユーザ ディレクトリ オブジェクトまたは間違ったユーザ DN。
- Sm_PolicyApi_NoPrivilege。呼び出し元には適切な権限がありません。