ITAddress

ITAddress インターフェイスは Address オブジェクトの基底インターフェイスです。アプリケーションはこのインターフェイスを使用して、Address オブジェクトに関する情報の取得や Address オブジェクトの利用を行います。

get_State メソッドは、アドレスの現在の状態を pAddressState に取得します。

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

get_AddressName メソッドは、アドレスの表示可能な名前を取得します。

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

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

get_ServiceProviderName メソッドは、このアドレスをサポートするテレフォニーサービスプロバイダー (TSP) の名前を取得します。たとえば、Unimodem サービスプロバイダーの場合は Unimdm.tsp、H323 サービスプロバイダーの場合は H323.tsp などです。

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

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

AddressCapString に ACS_PROVIDERSPECIFIC を設定した ITAddressCapabilities::get_AddressCapabilityString を使用すると、TSP 依存の形式でプロバイダー名を取得できます。これは、TAPI 2.x の LINEDEVCAPS 構造体の dwProviderInfoOffset メンバーにある文字列を返します。

get_TAPIObject メソッドは、このアドレスを所有する TAPI オブジェクトへのポインターを取得します。

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

CreateCall メソッドは、発信通話を行うために使用できる新しい Call オブジェクトを作成し、そのオブジェクトの ITBasicCallControl インターフェイスへのポインターを返します。新しく作成された通話は CS_IDLE 状態にあり、メディアやターミナルは選択されていません。

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

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

アドレスタイプが LINEADDRESSTYPE_SDP の場合、アプリケーションは、格納されている SDP 情報が RFC 2327 に従って正しく構築されていることを確認するために、pDestAddress に対して ITSDP::get_IsValid メソッドを呼び出す必要があります。

会議、転送、または着信転送 (フォワード) の操作中などに使用される相談 (コンサルテーション) 通話は、このメソッドを使用して作成する必要があります。

TAPI は、ITAddress::CreateCall によって返される ITBasicCallControl インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITBasicCallControl インターフェイスに対して Release を呼び出す必要があります。

get_Calls メソッドは、アドレス上で現在アクティブな通話のコレクションを作成します。このメソッドは、Visual Basic で記述されたものなどの Automation クライアントアプリケーション向けに提供されています。C および C++ アプリケーションは EnumerateCalls メソッドを使用する必要があります。

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

TAPI は、ITAddress::get_Calls によって返される ITCallInfo インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITCallInfo インターフェイスに対して Release を呼び出す必要があります。

EnumerateCalls メソッドは、現在のアドレス上の通話を列挙します。このメソッドは C および C++ アプリケーション向けに提供されています。Visual Basic で記述されたものなどの Automation クライアントアプリケーションは、get_Calls メソッドを使用する必要があります。

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

TAPI は、ITAddress::EnumerateCalls によって返される IEnumCall インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IEnumCall インターフェイスに対して Release を呼び出す必要があります。

get_DialableAddress メソッドは、このアドレスへの接続に使用できる BSTR を取得します。この BSTR は、電話番号や電子メール名など、別のアプリケーションがこのアドレスへの接続に使用する宛先アドレス文字列に対応します。

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

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

この値が利用できるかどうかはサービスプロバイダーによって異なります。たとえば、Unimodem サービスプロバイダーによって公開されるアドレスでは、このメソッドは電話番号ではなく空の文字列を返します。

CreateForwardInfoObject メソッドは、転送情報オブジェクトを作成し、ITForwardInformation インターフェイスポインターを返します。

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

アプリケーションは、新しく作成された ITForwardInformation オブジェクトを使用できるようにする前に、そのオブジェクトに情報を設定する必要があります。

TAPI は、ITAddress::CreateForwardInfoObject によって返される ITForwardInformation インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITForwardInformation インターフェイスに対して Release を呼び出す必要があります。

Forward メソッドは、ITForwardInformation に含まれる転送の指示に従って、アドレス宛ての通話を転送します。pForwardInfo が NULL に設定されている場合、転送はキャンセルされます。

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

pForwardInfo 内の情報は、それまでの転送の指示をすべて上書きします。

fDoNotDisturb を VARIANT_FALSE に設定して ITAddress::put_DoNotDisturb を呼び出すと、すべての転送がキャンセルされます。

アプリケーションは、 ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) を呼び出し、 LINEADDRCAPFLAGS_ 定数のメンバーであるフラグ LINEADDRCAPFLAGS_FWDCONSULT が plCapability に設定されているかどうかを確認することで、NULL 以外の相談通話が必要かどうかを判断できます。設定されている場合は、 Forward メソッドの pCall パラメーターに NULL 以外の値が必要です。

Forward メソッドは、部分的には TAPI 2.1 の LineForward 関数の COM ラッパーです。

get_CurrentForwardInfo メソッドは、現在の転送情報オブジェクトへのポインターを取得します。

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

TAPI は、ITAddress::get_ForwardInfo によって返される ITForwardInformation インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITForwardInformation インターフェイスに対して Release を呼び出す必要があります。

put_MessageWaiting メソッドは、アドレスのメッセージ待機の状態を設定します。

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

TAPI 2.x: に精通しているプログラマー向け: このメソッドは、 lineSetLineDevStatus を呼び出すことで、 LINEDEVSTATUS 構造体の dwDevStatusFlags メンバーにあるフラグ LINEDEVSTATUSFLAGS_MSGWAIT のオン/オフを切り替えます。

get_MessageWaiting メソッドは、アドレスにメッセージが待機しているかどうかを判断します。

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

TAPI 2.x では、これは構造体 LINEDEVSTATUS のメンバー dwDevStatusFlags にフラグ LINEDEVSTATUSFLAGS_MSGWAIT が設定されているかどうかに対応します。

put_DoNotDisturb メソッドは、応答不可 (do not disturb) の状態を設定します。応答不可機能は、すべてのアドレスで利用できるとは限りません。

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

DoNotDisturb 機能は転送を使用して実装されています。 put_DoNotDisturb が VARIANT_TRUE で呼び出されると、Tapi3.dll は、モードを LINEFORWARDMODE_UNCOND に設定し、宛先アドレスを NULL に設定した LINEFORWARD 項目を 1 つだけ持つ LINEFORWARD リストを作成します。 put_DoNotDisturb が VARIANT_FALSE で呼び出されると、Tapi3.dll は、 ITAddress::Forward で設定された転送ルールも含め、このアドレスの転送を完全にキャンセルします。

get_DoNotDisturb メソッドは、アドレスにおける応答不可 (do not disturb) 機能の現在の状態を取得します。応答不可機能は、すべてのアドレスで利用できるとは限りません。

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

TAPI 2.x: に精通しているプログラマー向け: DoNotDisturb 機能は、アドレスに存在する場合、"forward" 機能を使用して実装されます。 get_DoNotDisturb が呼び出されると、Tapi3.dll はアドレスオブジェクトの LINEADDRESSSTATUS を取得し、その LINEFORWARD エントリを探します。そのようなエントリが 1 つ見つかり、その dwDestAddressOffset メンバーが 0 (ゼロ) の場合、DoNotDisturb はオンになっているとみなされ、したがってこのメソッドの値として VARIANT_TRUE が返されます。