InfoDirectory使用手引書

5.2.12.2 ldap_extended_operation_s

　この関数は、同期型でプロトコルの拡張を行います。この関数では、LDAPコントロールを指定することができます。

【指定形式】

　int　　　　ldap_extended_operation_s(
　　　　　　　　　LDAP　　　　　　*ld,
　　　　　　　　　char　　　　　　*exoid,
　　　　　　　　　struct berval　 *exdata,
　　　　　　　　　LDAPControl　　**serverctrls,
　　　　　　　　　LDAPControl　　**clientctrls,
　　　　　　　　　char　　　　　 **retoidp,
　　　　　　　　　struct berval　**retdatap
　　　　　);

【パラメタの説明】

• ld

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

• exoid

  　追加する拡張リクエストに対応したOIDのアドレスを指定します。OIDは、“.”（ドット）で区切られた数字の文字列として設定します。

• exdata

  　プロトコル拡張要求に添付するデータのアドレスを指定します。添付するデータがない場合には、NULLを指定します。

• serverctrls

  　サーバコントロールのアドレスを設定した、ポインタ配列のアドレスを指定します。サーバコントロールを使用しない場合は、このパラメタにNULLを指定します。ここで指定したサーバコントロールは、InfoDirectoryサーバへの変更要求に添付されます。

• clientctrls

  　クライアントコントロールのアドレスを設定した、ポインタ配列のアドレスを指定します。ただし、本ライブラリではクライアントコントロールをサポートしていないため、このパラメタにはNULLを指定します。

• retoidp

  　サーバから通知されたOIDのアドレスを設定する、ポインタ変数のアドレスを指定します。

• retdatap

  　サーバから通知された添付データのアドレスを設定する、ポインタ変数のアドレスを指定します。

【復帰値】

　この関数では、復帰値としてLDAPエラーコードを返します。

• 正常完了の場合 ： LDAP_SUCCESS
• 異常完了の場合 ： LDAP_SUCCESS以外のLDAPエラーコード

　正常完了の場合は、通知されたOIDと添付データのアドレスが、retoidpパラメタとretdatapパラメタに設定されます。

【注意事項】

• 使用する際の制限

  　この関数は、LDAP V2プロトコルの場合には使用できません。

• サーバコントロール

  　サーバコントロールの形式については、LDAPコントロールを参照してください。

• LDAPエラーコード

  　LDAPエラーコードの値については、LDAPエラーコードを参照してください。