InfoDirectory SDK 使用手引書

2.1.2 同期型関数と非同期型関数

　ユーザ認証およびLDAP操作の関数には、同期型と非同期型があります。

• 同期型関数

  　同期型の関数は、処理結果を受信してから呼出し元に復帰します。このとき、受信した処理の結果が通知されます。

• 非同期型関数

  　非同期型の関数では、InfoDirectoryサーバへの要求送信が完了した時点で呼出し元に復帰します。このとき、開始された処理のメッセージIDを通知します。
  非同期型関数の場合、関数から復帰した時点では処理が完了していません。メッセージIDを指定して、処理結果を受信することが必要です。非同期型関数の処理結果を受信することについては、result情報の操作を参照してください。

　同期型と非同期型の違いを、以下に示します。

[表: 同期型と非同期型の違い]

項目	タイプ
	同期型関数	非同期型関数
復帰のタイミング	すべての処理が完了すると復帰します。	InfoDirectoryサーバへの送信が完了すると復帰します。
処理結果の通知	呼出し元に復帰した際に通知されます。	result情報の受信処理で通知されます。
処理結果の受信処理	不要です。	必要です。
呼出し元プログラムの処理	簡単です。	複雑です。
処理の効率	低いです。	高いです。(※)

　※　呼出し元プログラムは、LDAPの処理が完了するまでの間に、ほかの処理を行うことができます。