InfoDirectory SDK 使用手引書

2.1.1.4 result情報の操作

result情報の受取り

　非同期型のLDAP操作関数では、InfoDirectoryサーバへ要求を送信後、呼出し元に復帰します。

　InfoDirectoryサーバから送信されるresult情報（処理結果）を受信するために、ldap_result()を呼出す必要があります。

　ldap_result()を呼出すと、InfoDirectoryサーバからresult情報を受信後、呼出し元に復帰します。ldap_result()では、以下のパラメタを指定します。

• メッセージID

  　非同期型関数を発行する際に通知される値を指定します。

  　特定の非同期型関数のresult情報を待つ場合、特定の関数のメッセージIDを指定します。待ち合せる非同期型関数を特定しない場合、LDAP_RES_ANYを指定します。

• 受信処理タイプ

  　処理結果を受信する際の、処理の種類を指定します。

  • 一括受信（最後まで受信してから復帰）
  • 順次受信（1件受信で復帰）
  • 受信済メッセージ通知（受信済みの分の読込み）

  　一括受信の場合、要求に対する最後のメッセージを受信後、呼出し元に復帰します。順次受信の場合、1件のメッセージを受信するとすぐに呼出し元に復帰します。

• 受信待ちタイマ

  　指定された時間内にメッセージを受信しなかった場合、呼出し元にLDAP_TIMEOUTが通知されます。

  　ldap_result()は、関数の復帰値として、受信したresult情報の種類を返します。復帰値を利用して、どの非同期処理に対するresult情報か判定できます。ldap_result()については、処理結果の受取り／判定を参照してください。

   

result情報の判定

　受信したresult情報のメッセージIDや種類を判定する場合、以下の関数を使用します。

• ldap_msgid() ： メッセージIDの参照
• ldap_msgtype() ： メッセージの種類の参照

   

result情報の解析

　同期型関数やldap_result()で通知されたresult情報は、そのままではアプリケーションプログラムで使用できません。

　受信したresult情報を参照、解析する場合、以下の関数を使用します。

• ldap_parse_result()

  　result情報に含まれている情報を読込んで、パラメタで指定された変数に格納します。

  　通知される情報には、以下のものがあります。

  • LDAPエラーコード
  • 詳細エラーメッセージの文字列
  • 適合したDNの範囲(LDAPエラーコードがLDAP_NO_SUCH_OBJECTの場合)
    　
• ldap_err2string()

  　指定されたLDAPエラーコードに対応するエラーメッセージの文字列を返します。