Interstage Application Server Smart Repository運用ガイド

6.2.17.4 DNの読込み／解析

6.2.17.4.1 ldap_get_dn

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

【指定形式】

char  *ldap_get_dn(
        LDAP  *ld,
        LDAPMessage  *entry
        );

【パラメタの説明】

• ld

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

• entry

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

【復帰値】

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

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

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

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

【注意事項】

• 動的メモリの解放

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

   

6.2.17.4.2 ldap_explode_dn

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

【指定形式】

char  **ldap_explode_dn(
        char  *dn,
        int  notypes
        );

【パラメタの説明】

• dn

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

• notypes

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

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

【復帰値】

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

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

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

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

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

【注意事項】

• 動的メモリの解放

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

   

6.2.17.4.3 ldap_explode_rdn

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

【指定形式】

char  **ldap_explode_rdn(
        char  *rdn,
        int  notypes
        );

【パラメタの説明】

• rdn

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

• notypes

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

  • 0 ： タイプ情報を付加した形式で通知します。
  • 1 ： タイプ情報を取り除いた形式で通知します。(cn=User1 ---> User1)

【復帰値】

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

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

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

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

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

【注意事項】

• 動的メモリの解放

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

   

6.2.17.4.4 ldap_dn2ufn

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

【指定形式】

char  *ldap_dn2ufn(
        char  *dn
       );

【パラメタの説明】

• dn

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

【復帰値】

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

• 正常完了の場合 ： ユーザフレンドリなDNのアドレス
• 異常完了の場合 ： NULL

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

  • 使用可能なメモリが不足しました。

【注意事項】

• 動的メモリの解放

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