1.20.13 動的メモリの解放インタフェース

関数名	関数の説明
ber_free()	指定されたBerElement構造体を解放します。
ldap_ber_free()	指定されたBerElement構造体を解放します。
ldap_memfree()	LDAPのAPI関数が動的に獲得した領域を解放します。
ldap_msgfree()	ldap_result()で通知されたメッセージリストを解放します。
ldap_value_free()	文字列データのポインタ配列を解放します。
ldap_value_free_len()	バイナリデータのポインタ配列を解放します。

1.20.13.1 ber_free()

名前

ber_free

形式

  #include "idldap.h"
  void  ber_free(
          BerElement  *ber,
          int  freebuf );

機能説明

この関数は、指定されたBerElement構造体の領域を解放します。

パラメタ

ber: 解放するBerElement構造体のアドレスを指定します。

freebuf

0 ： berパラメタのメンバとして保持される領域は解放されません。berパラメタで指定されたアドレスの領域だけが解放されます。
0以外： berパラメタのメンバとして保持される領域、およびberパラメタで指定されたアドレスの領域のすべてが解放されます。

復帰値

なし。

1.20.13.2 ldap_ber_free()

名前

ldap_ber_free

形式

  #include "idldap.h"
  void  ldap_ber_free(
          BerElement  *ber,
          int  freebuf );

機能説明

この関数は、指定されたBerElement構造体の領域を解放します。このインタフェースは推奨されません。互換性の維持のために残されています。今後は、ber_free()を使用してください。

パラメタ

ber: 解放するBerElement構造体のアドレスを指定します。

freebuf

0 ： berパラメタのメンバとして保持される領域は解放されません。berパラメタで指定されたアドレスの領域だけが解放されます。
0以外： berパラメタのメンバとして保持される領域、およびberパラメタで指定されたアドレスの領域のすべてが解放されます。

復帰値

なし。

1.20.13.3 ldap_memfree()

名前

ldap_memfree

形式

  #include "idldap.h"
  void  ldap_memfree(
          char  *ptr );

機能説明

この関数は、指定されたデータ領域を解放します。

パラメタ

ptr: 解放する領域のアドレスを指定します。

復帰値

なし。

1.20.13.4 ldap_msgfree()

名前

ldap_msgfree

形式

  #include "idldap.h"
  int  ldap_msgfree(
          LDAPMessage  *res );

機能説明

この関数は、指定されたメッセージリストを解放します。

パラメタ

res: 解放するメッセージリストのアドレスを指定します。

復帰値

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

正常終了： 1以上
異常終了： 0
異常終了の場合、以下の原因が考えられます。
- パラメタの指定に誤りがあります。

1.20.13.5 ldap_value_free()

名前

ldap_value_free

形式

  #include "idldap.h"
  void  ldap_value_free(
          char  **vals );

機能説明

この関数は、指定された文字列のポインタ配列を解放します。

パラメタ

vals: 解放する文字列のポインタ配列のアドレスを指定します。

復帰値

なし。

1.20.13.6 ldap_value_free_len()

名前

ldap_value_free_len

形式

  #include "idldap.h"
  void  ldap_value_free_len(
          struct berval  **vals );

機能説明

この関数は、指定されたberval構造体のポインタ配列を解放します。

パラメタ

vals: 解放するberval構造体のポインタ配列のアドレスを指定します。

復帰値

なし。