InfoDirectory使用手引書

5.2.10.2 ldap_add_s

　この関数は、同期型でエントリの追加を行います。

【指定形式】

　int　　　　ldap_add_s(
　　　　　　　　　LDAP　　　*ld,
　　　　　　　　　char　　　*dn,
　　　　　　　　　LDAPMod　 *attrs[]
　　　　　);

【パラメタの説明】

• ld

  　ldap_init()またはldapssl_init()で通知された、セションハンドルを指定します。

• dn

  　追加するエントリの、DNのアドレスを指定します。

• attrs

  　LDAPMod構造体のポインタ配列アドレスを指定します。各LDAPMod構造体には、エントリに付加する属性名と属性値を設定します。LDAPMod構造体の各項目には、以下の値を設定します。

  • mod_op

    　属性値の種類を指定します。

    　・属性値が文字列データの場合 ： 0
    　・属性値がバイナリデータの場合 ： LDAP_MOD_BVALUES

  • mod_type

    　属性名のアドレスを指定します。LDAP V3プロトコルの場合、一部の属性では属性名に“;binary”を付加したものを指定する必要があります。

  • mod_vals

    　属性値のアドレスを指定します。ここで指定する属性値は、mod_vals共用体のポインタ配列です。このポインタ配列は、最後の項目にNULLが設定されている必要があります。 mod_vals共用体のメンバは、mod_opパラメタに指定された属性値の種類によって、以下のどちらかを使用します。

    　・文字列データの場合 ： mod_valuesに、属性値のポインタ配列のアドレスを指定します。
    　・バイナリデータの場合 ： mod_bvaluesに、berval構造体のポインタ配列のアドレスを指定します。berval構造体には、属性値のアドレスとサイズを指定します。

    　各属性値のポインタ配列は、最後の項目にNULLが設定されている必要があります。

  　エントリを追加する場合のパラメタの例については、add処理におけるパラメタの構成を参照してください。

【復帰値】

　この関数では、復帰値としてLDAPエラーコードを返します。

• 正常完了の場合 ： LDAP_SUCCESS
• 異常完了の場合 ： LDAP_SUCCESS以外のLDAPエラーコード

【注意事項】

• 追加可能なエントリ

  　親となるエントリが存在しない場合には、指定されたエントリを追加することができません。

• LDAPエラーコード

  　LDAPエラーコードの値については、LDAPエラーコードを参照してください。