Sm_PolicyApi_AddRealm()

この関数は、pStructRealm で指定されたドメイン内に stmndr レルムを作成します。pStructRealm 構造には、レルムを保護するエージェントまたはエージェント グループなどの、レルムの他の属性も含まれます。
casso127jpjp
この関数は、
pStructRealm
で指定されたドメイン内に
CA Single Sign-on
レルムを作成します。
pStructRealm
構造には、レルムを保護するエージェントまたはエージェント グループなどの、レルムの他の属性も含まれます。
保護するエージェントまたはエージェント グループが指定されていない場合、Sm_PolicyApi_AddRealm() は失敗します。
新規レルムがトップレベルのレルムである場合は、
pszParentRealmOid
(Sm_PolicyApi_Realm_t 内の)をドメイン OID に設定します。トップレベルのレルムでない場合は、
pszParentRealmOid
を新規親レルムの OID に設定します。
レルムが存在し、
bUpdate
フラグが「true」の場合、既存アイテムが更新されます。
許可ディレクトリをレルムに正常に追加するためには、クライアント アプリケーションで以下の条件を満たす必要があります。
  • 許可ユーザ ディレクトリと認証ユーザ ディレクトリとの間のディレクトリ マッピングが存在する。
    注:
    ポリシー管理 API は、許可ユーザ ディレクトリが存在するかどうかの確認のみ検証します。この API は、指定された許可ユーザ ディレクトリに対してディレクトリ マッピングを検証しません。
  • 関連する認証ユーザ ディレクトリが、ドメインのユーザ ディレクトリ コレクションに存在する。
Type
レルム関数、ドメイン範囲。
構文
int SM_EXTERN Sm_PolicyApi_AddRealm (
void*pSessionHandle,Sm_PolicyApi_Realm_t*pStructRealm,const boolbUpdate
);
パラメータ
I/O
説明
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
pStructRealm
I
値の入力が完了している構造体へのポインタです。
bUpdate
I
既存のオブジェクトが見つかる場合にそれが更新されることを示すフラグです。
 戻り値
  • Sm_PolicyApi_Success
    レルムが正常に作成されました
  • Sm_PolicyApi_Failure
    レルムが正常に作成されませんでした
  • Sm_PolicyApi_NoSession
    有効な管理者セッションがありません
  • Sm_PolicyApi_InvalidHandle
    このコールの前に有効な初期化がありません
  • Sm_PolicyApi_NoPrivilege 管理者には、レルムを作成する権限がありません
  • Sm_PolicyApi_InvalidOid:
    • レルム OID が更新中に見つかりませんでした
    • ドメイン OID が見つかりませんでした
    • エージェント OID またはエージェント グループ OID が見つかりませんでした
    • 方式 OID が見つかりませんでした
    • 親 OID を見つけることができませんでした(親 OID は、レルム OID またはドメイン OID になることができます。)