セッション識別子 の概要で説明されているように、呼び出しハンドルは TAPI 2.2 アプリケーションが特定の通信セッションを識別する手段です。 アプリケーションがセッションを開始すると、TAPI はそれ以降の操作またはクエリで使用する呼び出しハンドルを返します。 アプリケーションが受信セッションの通知を受け取ると、TAPI は呼び出しハンドルも渡します。
セッションが終了し、セッション状態がアイドル状態になった後、呼び出しハンドルは、アプリケーションがハンドルの割り当てを解除するか、行が閉じられるまで有効なままです。 この行は、アプリケーションによって閉じられたり、LINE_CLOSE メッセージを受け取ったりすることがあります。 回線を閉じると、その回線の呼び出しに対するすべての呼び出しハンドルがすぐに無効になります。
呼び出しがアイドル状態 に戻った後も、アプリケーションは呼び出しの情報の構造と状態を読み取ることができます。 これにより、アプリケーションは、lineGetCallInfo などの操作を使用して、ログ記録のために呼び出し情報を取得できます。
アイドル呼び出しのハンドルにアプリケーションがそれ以上使用していない場合は、lineDeallocateCall呼び出して、呼び出しに関連するシステム割り当てメモリを解放する必要があります。 TAPI は、呼び出しへのハンドルを持つ各アプリケーションの呼び出しごとにメモリを割り当てます。 サービス プロバイダーは、呼び出し情報を保持するためにメモリを割り当てる可能性があります。 アプリケーションの呼び出しハンドルの割り当てを解除すると、ライブラリとサービス プロバイダーはこれらのメモリ リソースを再利用できます。 呼び出しに対するアプリケーションのハンドルは、割り当てが正常に解除されると無効になります。
アプリケーション自体は、独自の目的で割り当てた呼び出しに関連するメモリを解放する必要があります。