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

1.20.7.2 ldap_rename_s()

名前

　ldap_rename_s

形式

　#include "idldap.h"
　int  ldap_rename_s(
　        LDAP  *ld,
　        const char  *dn,
　        const char  *newrdn,
　        const char  *newparent, 
　        int  deleteoldrdn, 
　        LDAPControl  **serverctrls,
　        LDAPControl  **clientctrls );

機能説明

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

　ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。

パラメタ

　ld

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

　dn

　名前を変更するエントリの、DNのアドレスを指定します。

　newrdn

　このエントリの、新しいRDNのアドレスを指定します。

　newparent

　このパラメタでは、新しいエントリの親となるエントリの、DNのアドレスを指定します。新しいエントリをもとのエントリと同じ場所に置く場合は、このパラメタにNULLを指定します。

　deleteoldrdn

　このパラメタでは、もとのRDNに該当する属性値を、エントリから削除するかどうかを指定します。

• もとのRDNに該当する属性値を削除する場合 ： 0以外の値
• もとのRDNに該当する属性値を削除しない場合 ： 0

　0を指定した場合、RDNではない属性値として、エントリに残されます。

　serverctrls

　Smart Repositoryではサーバコントロールをサポートしていないため、このパラメタにはNULLを指定します。

　clientctrls

　本ライブラリではクライアントコントロールをサポートしていないため、このパラメタにはNULLを指定します。

復帰値

　この関数では、復帰値としてLDAPエラーコードを返します。LDAPエラーコードの値については、“メッセージ集”の“LDAPエラーコード”を参照してください。

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