Sm_PolicyApi_SetUserPasswordState()

UserPasswordState オブジェクトを追加または更新します。
casso127jpjp
UserPasswordState オブジェクトを追加または更新します。
ユーザと関連付けられた PasswordState がなければ、新しい PasswordState が作成されます。そうでないと、UserPasswordState が更新されます。
Type
パスワード状態関数。
構文
int SM_EXTERN Sm_PolicyApi_SetUserPasswordState (
void*pSessionHandle,
const char*pszUserDirOid,
const char*pszUserDN,
Sm_PolicyApi_UserPasswordState_t*pPasswordState
bool bEmptyHistory
);
パラメータ
I/O
説明
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
pszUserDirOid
I
特定のユーザ ディレクトリに相当する一意のオブジェクト識別子。
pszUserDN
I
ユーザ ディレクトリ内のユーザの識別名を指定します。
pPasswordState
I/O
ユーザ パスワード状態オブジェクト。
パスワードが最後に変更された日時に関するユーザ ディレクトリ設定がこのパラメータによって変更され、かつパスワードが
CA Single Sign-on
の外部でリセットされた場合は、パスワード再利用を防ぐパスワード ポリシーが予期したとおりには機能しないことがあります。
このパラメータが 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。呼び出し元には適切な権限がありません。