Interstage Application Server Smart Repository運用ガイド |
目次 索引 |
第5章 アプリケーションの作成(C API) | > 5.2 C API仕様 |
関数名 |
関数の説明 |
---|---|
指定されたエントリを追加します。 |
|
指定されたエントリを追加します。 |
|
指定されたエントリを追加します。 |
|
指定されたエントリを追加します。 |
この関数は、非同期型でエントリの追加を行います。親となるエントリが存在しない場合には、指定されたエントリを追加することができません。
非同期関数の処理結果を受け取る場合、ldap_result()を使用します。この時、ldap_add()の復帰値として返されたメッセージIDを指定します。詳細は、“処理結果の受取り/判定”を参照してください。
ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。
【指定形式】
#include "idldap.h" int ldap_add( LDAP *ld, char *dn, LDAPMod **attrs ); |
【パラメタの説明】
ldap_init()、またはldapssl_init()で通知された、セションハンドルを指定します。
追加するエントリの、DNのアドレスを指定します。
LDAPMod構造体のポインタ配列アドレスを指定します。各LDAPMod構造体には、エントリに付加する属性名と属性値を設定します。LDAPMod構造体の各項目には、以下の値を設定します。
属性値の種類を指定します。
属性名のアドレスを指定します。一部の属性では属性名に“;binary”を付加したものを指定する必要があります。
属性値のアドレスを指定します。
ここで指定する属性値は、mod_vals共用体のポインタ配列です。このポインタ配列は、最後の項目にNULLが設定されている必要があります。mod_vals共用体のメンバは、mod_opパラメタに指定された属性値の種類によって、以下のどちらかを使用します。
各属性値のポインタ配列は、最後の項目にNULLが設定されている必要があります。
以下のエントリをツリーに追加する場合のパラメタの例を、下図に示します。
cn: user001 |
【復帰値】
この関数は、復帰値として以下の値を返します。
異常完了の場合、以下の原因が考えられます。
この関数は、同期型でエントリの追加を行います。親となるエントリが存在しない場合には、指定されたエントリを追加することができません。
ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。
【指定形式】
#include "idldap.h" int ldap_add_s( LDAP *ld, char *dn, LDAPMod **attrs ); |
【パラメタの説明】
ldap_init()、またはldapssl_init()で通知された、セションハンドルを指定します。
追加するエントリの、DNのアドレスを指定します。
LDAPMod構造体のポインタ配列アドレスを指定します。各LDAPMod構造体には、エントリに付加する属性名と属性値を設定します。LDAPMod構造体の各項目には、以下の値を設定します。
属性値の種類を指定します。
属性名のアドレスを指定します。一部の属性では属性名に“;binary”を付加したものを指定する必要があります。
属性値のアドレスを指定します。ここで指定する属性値は、mod_vals共用体のポインタ配列です。このポインタ配列は、最後の項目にNULLが設定されている必要があります。 mod_vals共用体のメンバは、mod_opパラメタに指定された属性値の種類によって、以下のどちらかを使用します。
各属性値のポインタ配列は、最後の項目にNULLが設定されている必要があります。
エントリを追加する場合のパラメタの例については、“add処理におけるパラメタの構成”を参照してください。
【復帰値】
この関数では、復帰値としてLDAPエラーコードを返します。LDAPエラーコードの値については、“LDAPエラーコード”を参照してください。
この関数は、非同期型でエントリの追加を行います。親となるエントリが存在しない場合には、指定されたエントリを追加することができません。
非同期関数の処理結果を受け取る場合、ldap_result()を使用します。この時、ldap_add_ext()の復帰値として返されたメッセージIDを指定します。詳細は、“処理結果の受取り/判定”を参照してください。
ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。
【指定形式】
#include "idldap.h" int ldap_add_ext( LDAP *ld, char *dn, LDAPMod **attrs, LDAPControl **serverctrls, LDAPControl **clientctrls, int *msgidp ); |
【パラメタの説明】
ldap_init()、またはldapssl_init()で通知された、セションハンドルを指定します。
追加するエントリの、DNのアドレスを指定します。
LDAPMod構造体のポインタ配列アドレスを指定します。各LDAPMod構造体には、エントリに付加する属性名と属性値を設定します。LDAPMod構造体の各項目には、以下の値を設定します。
属性値の種類を指定します。
属性名のアドレスを指定します。一部の属性では属性名に“;binary”を付加したものを指定する必要があります。
属性値のアドレスを指定します。ここで指定する属性値は、mod_vals共用体のポインタ配列です。このポインタ配列は、最後の項目にNULLが設定されている必要があります。 mod_vals共用体のメンバは、mod_opパラメタに指定された属性値の種類によって、以下のどちらかを使用します。
各属性値のポインタ配列は、最後の項目にNULLが設定されている必要があります。
エントリを追加する場合のパラメタの例については、“add処理におけるパラメタの構成”を参照してください。
Smart Repositoryではサーバコントロールをサポートしていないため、このパラメタにはNULLを指定します。
本ライブラリではクライアントコントロールをサポートしていないため、このパラメタにはNULLを指定します。
メッセージIDを格納するための変数のアドレスを指定します。
【復帰値】
この関数では、復帰値としてLDAPエラーコードを返します。LDAPエラーコードの値については、“LDAPエラーコード”を参照してください。
また、正常完了の場合には、msgidpパラメタが示す変数にメッセージIDが設定されています。
この関数は、同期型でエントリの追加を行います。親となるエントリが存在しない場合には、指定されたエントリを追加することができません。
ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。
【指定形式】
#include "idldap.h" int ldap_add_ext_s( LDAP *ld, char *dn, LDAPMod **attrs, LDAPControl **serverctrls, LDAPControl **clientctrls ); |
【パラメタの説明】
ldap_init()、またはldapssl_init()で通知された、セションハンドルを指定します。
追加するエントリの、DNのアドレスを指定します。
LDAPMod構造体のポインタ配列アドレスを指定します。各LDAPMod構造体には、エントリに付加する属性名と属性値を設定します。 LDAPMod構造体の各項目には、以下の値を設定します。
属性値の種類を指定します。
属性名のアドレスを指定します。一部の属性では属性名に“;binary”を付加したものを指定する必要があります。
属性値のアドレスを指定します。ここで指定する属性値は、mod_vals共用体のポインタ配列です。このポインタ配列は、最後の項目にNULLが設定されている必要があります。mod_vals共用体のメンバは、mod_opパラメタに指定された属性値の種類によって、以下のどちらかを使用します。
各属性値のポインタ配列は、最後の項目にNULLが設定されている必要があります。
エントリを追加する場合のパラメタの例については、“add処理におけるパラメタの構成”を参照してください。
Smart Repositoryではサーバコントロールをサポートしていないため、このパラメタにはNULLを指定します。
本ライブラリではクライアントコントロールをサポートしていないため、このパラメタにはNULLを指定します。
【復帰値】
この関数では、復帰値としてLDAPエラーコードを返します。LDAPエラーコードの値については、“LDAPエラーコード”を参照してください。
目次 索引 |