InfoDirectory使用手引書 |
目次 索引 |
第3部 SDK編 | > 第5章 アプリケーション開発環境(LDAP C API) | > 5.2 関数インタフェース | > 5.2.3 セションハンドルオプションの設定/参照 |
この関数は、セションハンドルオプションの値を設定します。【指定形式】
int ldap_set_option(
LDAP *ld,
int option,
void *optdata
);【パラメタの説明】
- ld
ldap_init()またはldapssl_init()で通知された、セションハンドルを指定します。
- option
設定するオプションの種類を指定します。
- optdata
オプションの設定値を格納した領域のアドレスを指定します。
【復帰値】
この関数では、復帰値としてLDAPエラーコードを返します。
- 正常完了の場合 : 0
- 異常完了の場合 : -1
【注意事項】
- 使用可能なオプション
使用可能なオプションの種類/設定値については、セションハンドルオプションを参照してください。
- サーバコントロール
サーバコントロールの形式については、LDAPコントロールを参照してください。また、サーバコントロールは、LDAP V3プロトコルの場合に有効です。
- クライアントコントロール
本ライブラリでは、クライアントコントロールをサポートしていません。このため、クライアントコントロールは指定できません。
- LDAPエラーコード
LDAPエラーコードの値については、LDAPエラーコードを参照してください。
- リフェラル
リフェラルの自動処理時には、セションハンドルオプションとして設定された値はリフェラル先の各InfoDirectoryサーバでも使用されます。
そのため、LDAP_OPT_SIZELIMIT(InfoDirectoryサーバが送信する最大エントリ数)を設定した場合、クライアントに通知される最大のエントリ数は、“(最初に要求を送信したInfoDirectoryサーバ+リフェラル先のInfoDirectoryサーバ数)×LDAP_OPT_SIZELIMIT”で設定した値となります。
同様にLDAP_OPT_TIMELIMIT(InfoDirectoryサーバでの最大検索時間)も、クライアントからは“(最初に要求を送信したInfoDirectoryサーバ+リフェラル先のInfoDirectoryサーバ数)×LDAP_OPT_TIMELIMIT”で設定した値がInfoDirectoryサーバでの最大検索時間となります。
目次 索引 |