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

1.20.12.12 ldap_explode_rdn()

名前

　ldap_explode_rdn

形式

　#include "idldap.h"
　char  **ldap_explode_rdn(
　        const char  *rdn,
　        int  notypes );

機能説明

　この関数は、指定されたRDNを、各構成要素に分解します。

パラメタ

　rdn

　RDNのアドレスを指定します。

　notypes

　出力する構成要素の形式として、以下の値を指定します。

• 0 ： 属性を付加した形式で通知します。
• 0以外 ： 属性を取り除いた形式で通知します。(cn=User1 ---> User1)

復帰値

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

• 正常終了の場合 ： 各構成要素のポインタ配列のアドレス
• 異常終了の場合 ： NULL

  　異常終了の場合、以下の原因が考えられます。

  • パラメタの指定に誤りがあります。
  • 使用可能なメモリが不足しました。

　ldap_explode_rdn()で通知されるデータについては、ldap_explode_dn()の場合と同じ形式です。

　DNに記号が含まれている場合、いくつかの記号は特殊文字として扱われ、変換されて出力されます。詳細は、ldap_explode_dn()の復帰値を参照してください。

注意事項

• 動的メモリの解放

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