Sm_PolicyApi_GetDisabledUserState()

ユーザの無効状態を取得します。
casso126jjp
ユーザの無効状態を取得します。
この関数を正常に動作させるには、ディレクトリ属性を指定して無効化されたユーザを追跡する必要があります。この属性はユーザ ディレクトリの無効フラグで指定されます。無効化の理由は 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
Description
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 が見つかりませんでした。