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

1.20.12.13 ldap_dn2ufn()

名前

　ldap_dn2ufn

形式

　#include "idldap.h"
　char  *ldap_dn2ufn(
　        const char  *dn );

機能説明

　この関数は、指定されたDNを、ユーザフレンドリな形式に変換します。ユーザフレンドリな形式への変換例を以下に示します。

　変換例

指定したDN	ユーザフレンドリな形式
"ou=interstage,o=fujitsu,dc=com"	"interstage, fujitsu, com"
"dc=fujitsu,dc=com"	"fujitsu.com"

パラメタ

　dn

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

復帰値

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

• 正常終了の場合 ： ユーザフレンドリな形式の文字列のアドレス
• 異常終了の場合 ： NULL

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

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

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

注意事項

• 動的メモリの解放

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