| InfoDirectory使用手引書 |
|
目次
索引
|
| 第3部 SDK編 | > 第5章 アプリケーション開発環境（LDAP C API） | > 5.2 関数インタフェース | > 5.2.17 検索結果の解析処理 |
この関数は、指定された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()を使用して解放しなければなりません。詳細は、動的メモリの解放を参照してください。
この関数は、指定された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_explode_dn()で通知された領域は、不要になった時点でldap_value_free()を使用して解放しなければなりません。詳細は、動的メモリの解放を参照してください。
この関数は、指定された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()を使用して解放しなければなりません。詳細は、動的メモリの解放を参照してください。
この関数は、指定されたDNを、ユーザフレンドリな形式に変換します。【指定形式】
char *ldap_dn2ufn(
char *dn
);【パラメタの説明】
- dn
変換するDNのアドレスを指定します。
【復帰値】
この関数は、復帰値として以下の値を返します。
- 正常完了の場合 ： ユーザフレンドリなDNのアドレス
- 異常完了の場合 ： NULL
【注意事項】
- 動的メモリの解放
ldap_dn2ufn()で通知された領域は、不要になった時点でldap_memfree()を使用して解放しなければなりません。詳細は、動的メモリの解放を参照してください。
|
目次
索引
|
