ITBasicCallControl

ITBasicCallControl インターフェイスは、アプリケーションがコールオブジェクトに対して接続、応答、および基本的なテレフォニー操作を実行するために使用します。

Connect メソッドは、発信コールの接続を完了しようとします。

このメソッドは、次のいずれかの値を返すことがあります。

コールが非同期の場合、アプリケーションは ITCallNotificationEvent アウトゴーイングインターフェイスを通じて、コールの進行状況に関する情報を受け取ります。アプリケーションは Connect を呼び出す前に、このアウトゴーイングインターフェイスを登録しておく必要があります。 Connect は S_OK を返す場合がありますが、実際の接続は失敗することがあります (その場合、アプリケーションはアウトゴーイングインターフェイスを通じて通知されます)。

コールが同期の場合、このメソッドはコールが接続状態になるか失敗するまで制御を返しません。

Answer メソッドは、着信コールに応答します。このメソッドは、コール状態が CS_OFFERING である場合にのみ成功します。

このメソッドは、次のいずれかの値を返すことがあります。

Disconnect メソッドは、コールを切断します。メソッドが正常に完了すると、コール状態は CS_DISCONNECTED に遷移します。

このメソッドは、次のいずれかの値を返すことがあります。

Hold メソッドは、コールを保留にする、または保留を解除します。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

HandoffDirect メソッドは、コールを別のアプリケーションにハンドオフします。これは、アプリケーションがそのコールの所有権を必要としなくなったことを示します。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

受信側のアプリケーションが、コールに関係するメディアタイプに対して回線を開いていない場合、ハンドオフは失敗します。TAPI がコールのハンドオフに失敗した場合、TAPI は Disconnect を呼び出します。

アプリケーションは、pApplicationName パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

HandoffIndirect メソッドは、コールのメディアタイプに基づいて、コールを別のアプリケーションにハンドオフします。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

TAPI がコールのハンドオフに失敗した場合、TAPI は Disconnect を呼び出します。

Conference メソッドは、現在のコールが参加している会議に、相談コール (consultation call) を追加します。関連する ITCallHub オブジェクトが存在しない場合は、新たに作成されます。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

相談コール (pCall) は ITAddress::CreateCall によって作成されます。接続は Finish メソッドを呼び出すことで完了します。このメソッドの使用例については、 Create a Simple Conference を参照してください。

Conference が呼び出されたときに相談コールが CONNECTED 状態でない場合、TAPI は (相談コールが最初に ITAddress::CreateCall で作成されたときに指定された) 宛先アドレスを使用して、その時点で接続を試みます。元のコールの宛先アドレスが NULL であった場合、Conference は E_INVALIDARG で失敗します。

Transfer メソッドは、現在のコールを宛先アドレスに転送します。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

コール転送では、転送の準備として相談コールを設定します。pCall は、相談コールの作成後に ITAddress::CreateCall によって返される ITBasicCallControl ポインターです。 ITBasicCallControl::Finish (FM_ASTRANSFER) が転送を完了します。

Transfer が呼び出されたときに相談コールが CONNECTED 状態でない場合、TAPI は (相談コールが最初に ITAddress::CreateCall で作成されたときに指定された) 宛先アドレスを使用して、その時点で接続を試みます。元のコールの宛先アドレスが NULL であった場合、 Transfer は E_INVALIDARG で失敗します。

BlindTransfer メソッドは、指定したコールを指定した宛先アドレスへ、ブラインド転送 (単一ステップ転送) します。アプリケーションはそのコールの所有者でなければなりません。転送が成功すると、コール状態は CS_DISCONNECTED に遷移します。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

アプリケーションは、pDestAddress パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

場合によっては、適切な形式の pDestAddress 文字列を取得するために、アプリケーションはアドレス変換インターフェイス ( ITAddressTranslation および ITAddressTranslationInfo) を使用する必要がある場合があります。

SwapHold メソッドは、(アクティブな) コールを、保留中の指定したコールと切り替えます。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

ParkDirect メソッドは、指定したアドレスにコールをパークします。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

ダイレクトパークでは、アプリケーションがコールをパークするアドレスを決定します。 ParkInDirect では、交換機 (スイッチ) がアドレスを決定し、それをアプリケーションに提供します。いずれの場合も、パークされたコールはこのアドレスを指定することでパーク解除できます。

パークされたコールは、正常にパークされた後、切断状態になります。

一部の交換機は、コールが長時間パークされたままになっていると、ユーザーにリマインダーを通知できます。アプリケーションには、コール理由がリマインダーに設定された着信コールが見えます。

アプリケーションは、pParkAddress パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

ParkIndirect メソッドは、コールをパークし、パークされたアドレスを返します。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

ParkDirect では、アプリケーションがコールをパークするアドレスを決定します。ノンダイレクトパークでは、交換機 (スイッチ) がアドレスを決定し、それをアプリケーションに提供します。いずれの場合も、パークされたコールはこのアドレスを指定することでパーク解除できます。

パークされたコールは、正常にパークされた後、切断状態になります。

一部の交換機は、コールが長時間パークされたままになっていると、ユーザーにリマインダーを通知できます。アプリケーションには、コール理由がリマインダーに設定された着信コールが見えます。

アプリケーションは、ppNonDirAddress パラメーターに割り当てられたメモリを解放するために SysFreeString を使用する必要があります。

Unpark メソッドは、パークからコールを取り出します。

このメソッドは、次のいずれかの値を返すことがあります。

パークされたコールをパーク解除するには、コールの現在のパーク先を宛先アドレスとして指定して CreateCall を呼び出す必要があります。以下の例を参照してください。

例

// 注: この呼び出しで使用されるパラメーターは、コードの別の場所から取得されます。

HRESULT hr = pAddress->CreateCall( bstrAddressToCall,
                           dwAddressType,
                           dwMediaTypes,
                           &pBasicCall
                           );
// ( hr != S_OK ) の場合は、ここでエラーを処理します。

// コールに適切なターミナルを選択してから、次を呼び出します:
pBasicCall->Unpark();

SetQOS メソッドは、コールのサービス品質 (QOS) レベルを設定します。

このメソッドは、次のいずれかの値を返すことがあります。

Pickup メソッドは、指定したグループ識別子で鳴動している (アラート中の) コールをピックアップします。

このメソッドは、次のいずれかの値を返すことがあります。

アプリケーションは、pGroupID パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

Dial メソッドは、指定したアドレスをダイヤルします。

このメソッドは、次のいずれかの値を返すことがあります。

アプリケーションは、pDestAddress パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

場合によっては、適切な形式の pDestAddress 文字列を取得するために、アプリケーションはアドレス変換インターフェイス ( ITAddressTranslation および ITAddressTranslationInfo) を使用する必要がある場合があります。

Dial メソッドは、コールがすでに存在するという点で ITAddress::CreateCall とは異なります。使用例としては、内線番号をダイヤルする場合が挙げられます。

Finish メソッドは、会議または転送を完了するために相談コールに対して呼び出されます。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

RemoveFromConference メソッドは、コールが会議に参加している場合、その会議からコールを削除します。

このメソッドは、次のいずれかの値を返すことがあります。

一部のサービスプロバイダーは、ストリーミングがアクティブな間はこの操作をサポートしません。アプリケーションは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。