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

1.20.12.11 ldap_explode_dn()

名前

　ldap_explode_dn

形式

　#include "idldap.h"
　char  **ldap_explode_dn(
　        const char  *dn,
　        int  notypes );

機能説明

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

パラメタ

　dn

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

　notypes

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

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

復帰値

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

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

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

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

　ldap_explode_dn()で通知されるデータの例を、下図に示します。

　DNに記号が含まれている場合、以下の記号は特殊文字として扱われます。特殊文字は変換されて出力されます。

入力文字	出力文字
“"”(ダブルクォーテーション)	\22
“#”(シャープ)	\23
“+”(プラス)	\2B
“,”(カンマ)	\2C
“;”(セミコロン)	\3B
“<”(小なり)	\3C
“>”(大なり)	\3E
“\”(エンマーク)	\5C

注意事項

• 動的メモリの解放

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