Sm_PolicyApi_AddSAMLAffiliation()

新規 SAML アフィリエーション オブジェクトを追加するか、または既存の SAML アフィリエーション オブジェクトを変更します。
casso127jpjp
新規 SAML アフィリエーション オブジェクトを追加するか、または既存の SAML アフィリエーション オブジェクトを変更します。
Type
SAML 2.0 設定関数、グローバル範囲。
構文
int SM_EXTERN Sm_PolicyApi_AddSAMLAffiliation (
void*pSessionHandle,
Sm_PolicyApi_SAMLAffiliation_t*pstructAffiliation,
const boolbUpdate,
char**pszErrMsg
);
パラメータ
I/O
説明
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
pstructAffiliation
I
値が完全に入力されている SAML アフィリエーション構造体へのポインタです。
bUpdate
I
更新操作を既存のオブジェクトで実行するかどうかを指定します。
pszErrMsg
O
アフィリエーションが正常に追加または更新されない場合に、エラー メッセージを含む文字列です。
ポリシー管理 API はこのパラメータに対してメモリを動的に割り当てます。Sm_PolicyApi_FreeString() の呼び出しによるメモリの解放は、カスタム アプリケーションで行います。
Sm_PolicyApi_MissingProperty または Sm_PolicyApi_InvalidProp が返される場合、このフィールドには欠落または無効のプロパティ名が含まれます。
戻り値
  • Sm_PolicyApi_Success。操作は成功しました。
  • Sm_PolicyApi_Failure。操作は成功しませんでした。
  • Sm_PolicyApi_InvalidProp。指定されたプロパティは無効です。プロパティ名が
    pszErrMsg
    で返されます。
  • Sm_PolicyApi_MissingProperty。必要なプロパティが指定されませんでした。プロパティ名が
    pszErrMsg
    で返されます。
  • Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
  • Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
  • Sm_PolicyApi_NoPrivilege。Sm_PolicyApi_InvalidOid: 管理者には、SAML アフィリエーションを作成する権限がありません。
  • Sm_PolicyApi_InsufficientData。SAML アフィリエーションの設定に必要なプロパティがありませんでした。