Interstage Application Server Smart Repository運用ガイド |
目次 索引 |
第5章 アプリケーションの作成(C API) | > 5.1 C APIの使用方法 | > 5.1.2 LDAP操作の流れ |
Smart Repositoryサーバから送られてくるresult情報(処理結果)を受け取るためには、ldap_result()を呼び出す必要があります。
ldap_result()を呼び出すと、Smart Repositoryサーバからのresult情報を受信するまで待ってから、呼び出し元に復帰します。ldap_result()では、パラメタとして以下のものを指定します。
非同期型関数を発行する際に通知される値を指定します。
特定の非同期型関数のresult情報を待つ場合には、その関数のメッセージIDを指定します。待ち合わせる非同期型関数を特定しない場合には、LDAP_RES_ANYを指定します。
処理結果を受信する際の、処理の種類を指定します。
一括受信の場合、要求に対する最後のメッセージを受信してから、呼び出し元に復帰します。順次、受信の場合には、1件のメッセージを受信するとすぐに呼び出し元に復帰します。
ここで指定された時間以内にメッセージを受信しなかった場合、呼び出し元にLDAP_TIMEOUTが通知されます。
ldap_result()は、関数の復帰値として、受信したresult情報の種類を返します。これを利用して、どの非同期処理に対するresult情報か判定することができます。ldap_result()については、“処理結果の受取り/判定”を参照してください。
受信したresult情報のメッセージIDや種類を判定する場合、以下の関数を使用します。
同期型関数やldap_result()で通知されたresult情報は、そのままではアプリケーションプログラムで使用することができません。
受信したresult情報を参照、解析する場合、以下の関数を使用します。
result情報に含まれている情報を読み込んで、パラメタで指定された変数に格納します。
通知される情報には、以下のものがあります。
指定されたLDAPエラーコードに対応するエラーメッセージの文字列を返します。
目次 索引 |