Sm_PolicyApi_AddAgent()

新規 stmndr エージェントを作成します。エージェントの属性は pstructAgent 構造に含まれています。
casso127jpjp
新規
CA Single Sign-on
エージェントを作成します。エージェントの属性は
pstructAgent
構造に含まれています。
管理者オブジェクトが存在し、
bUpdate
フラグが「真」の場合、アイテムが更新されます。
この呼び出しでエージェント タイプを指定する必要があります。エージェントに対してエージェント タイプ OID を取得するには、Sm_PolicyApi_GetGlobalObjects() を使用します。
Type
エージェント関数、グローバル範囲。
構文
int SM_EXTERN Sm_PolicyApi_AddAgent (
void*
pSessionHandle
,
Sm_PolicyApi_Agent_t*
pstructAgent
,
const bool
bUpdate
);
パラメータ
I/O
説明
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
pstructAgent
I
値の入力が完了しているエージェント構造へのポインタです。
bUpdate
I
既存のオブジェクトが見つかる場合にそれが更新されることを示すフラグです。
 
戻り値
  • Sm_PolicyApi_Success。エージェントが正常に作成されました。
  • Sm_PolicyApi_Failure。エージェントが正常に作成されませんでした。
  • Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
  • Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
  • Sm_PolicyApi_NoPrivilege。管理者には、エージェントを作成する権限がありません。
  • Sm_PolicyApi_InvalidOid:
    • エージェント タイプ OID が見つからなかったか、または特定のエージェント タイプではありません。
    • エージェント OID が見つかりませんでした。これは、この関数が呼び出されるとき
      bUpdate
      の設定が「真」であり、Sm_PolicyApi_Agent_t の
      pszOid
      フィールドが更新中のエージェントの OID を保持する場合に生じます。
  • Sm_PolicyApi_NotUnique。同じ名前のエージェントが存在します。
  • Sm_PolicyApi_RadiusIpAddrNotUnique. 同一の RADIUS IP アドレスが別に存在します。
  • Sm_PolicyApi_MissingProperty。必須フィールドの 1 つが設定されていません。