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

1.20.14.3 ldap_conv_init()

名前

　ldap_conv_init

形式

　#include "idldap.h"
　ldap_conv_func  *ldap_conv_init(
　        int  code );

機能説明

　この関数は、ldap_conv_utf2()関数の初期化処理を行います。変換したい文字コードを指定することにより、UTF-8と指定した文字コード間での変換が可能となります。

　Unicode(UCS2)は、ビッグエンディアンとして処理します。

　Unicode(UCS2)は、リトルエンディアンとして処理します。

パラメタ

　code

　ldap_conv_utf2()で指定するinパラメタ、およびoutパラメタの、UTF-8でない方のコード種別を指定します。

• LDAP_CHARS_OPT_SJIS ： Shift JIS
• LDAP_CHARS_OPT_88591 ： ISO-8859-1
• LDAP_CHARS_OPT_UCS2 ： Unicode(UCS2)

• LDAP_CHARS_OPT_EUCJP ： EUC

復帰値

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

• 正常終了 ： -1
• 異常終了 ： なし

　Windows(R)版のこの関数は、Solaris版、およびLinux版と互換性を保つためにあります。そのため、必ず正常終了します。

• 正常終了 ： コード変換ハンドルのポインタ
• 異常終了 ： NULL

　エラーの詳細は、errnoを参照してください。

errno	意味
EINVAL	パラメタの指定に誤りがあります。
ENOMEM	メモリ不足が発生しました。
ENOENT	ライブラリのロードに失敗しました。

注意事項

• コード変換ハンドルの解放

  　ldap_conv_init()で獲得されたコード変換ハンドルの領域は、不要になった時点でldap_conv_close()を使用して解放しなければなりません。