Sm_PolicyApi_GetDisabledUserState()
ユーザの無効状態を取得します。
casso127jpjp
ユーザの無効状態を取得します。
この関数を正常に動作させるには、ディレクトリ属性を指定して無効化されたユーザを追跡する必要があります。この属性はユーザ ディレクトリの無効フラグで指定されます。無効化の理由は Sm_Api_DisabledReason_t に列挙され、それは SmApi.h で定義されています。
Type
ユーザとユーザ状態関数。
構文
int SM_EXTERN Sm_PolicyApi_GetDisabledUserState (void*pSessionHandle,const char*pszUserDirOid,const char*pszUserDN,Sm_Api_DisabledReason_t*nDisabledReason,char**pszErrMsg);
パラメータ | I/O | 説明 |
pSessionHandle
| I | 内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。 |
pszUserDirOid
| I | ユーザを含む既存ユーザ ディレクトリのオブジェクト識別子が含まれ、NULL で終わる文字列です。 |
pszUserDN
| I | 無効状態が変更されるユーザの識別名を含み、NULL で終わる文字列です。 |
nDisabledReason
| O | ユーザを無効または有効にする理由です。理由は Sm_Api_DisabledReason_t に列挙され、それは SmApi.h で定義されています。 |
pszErrMsg
| O | 取得が成功しなかった場合に、エラー メッセージがこの文字列に保持されます。Sm_PolicyApi_FreeString() を呼び出して、この変数に割り当てられたメモリを解放します。 |
戻り値
- Sm_PolicyApi_Success。取得は正常に行われました。
- Sm_PolicyApi_Failure:
- 無効化状態が取得されませんでした。
- pszErrMsgにメモリを割り当てることができませんでした。
- Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
- Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
- Sm_PolicyApi_NoPrivilege。管理者には、ユーザ無効状態を取得する権限がありません。
- Sm_PolicyApi_InvalidOid。ユーザ ディレクトリ OID が見つかりませんでした。