Interstage Application Server リファレンスマニュアル（API編）

1.20.12.10 ldap_get_dn()

名前

　ldap_get_dn

形式

　#include "idldap.h"
　char  *ldap_get_dn(
　        LDAP  *ld,
　        LDAPMessage  *entry );

機能説明

　この関数は、指定されたエントリのDNを読み込みます。

パラメタ

　ld

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

　entry

　ldap_first_entry()、またはldap_next_entry()によって通知された、エントリのアドレスを指定します。

復帰値

　この関数は、復帰値として以下の値を返します。

• 正常終了の場合 ： DNのアドレス
• 異常終了の場合 ： NULL

  　異常終了の場合のエラー原因は、ldap_get_option()のLDAP_OPT_RESULT_CODEオプションで参照してください。

注意事項

• 動的メモリの解放

  　ldap_get_dn()で通知されたDNの領域は、不要になった時点でldap_memfree()を使用して解放しなければなりません。詳細は、“動的メモリの解放インタフェース”を参照してください。