ITAddress::CreateCall メソッド (tapi3if.h)

[アーティクル]
03/05/2024

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

呼び出しアドレス、アドレスの種類、およびメディアの種類に使用できる入力値は、現在のアドレスをサポートするテレフォニーサービスプロバイダーに固有です。 Windows 2000 に付属する TSP の詳細については、「テレフォニーサービスプロバイダー (TSP) について」を参照してください。サードパーティの TSP については、ベンダーが提供するドキュメントを参照してください。

構文

HRESULT CreateCall(
  [in]  BSTR               pDestAddress,
  [in]  long               lAddressType,
  [in]  long               lMediaTypes,
  [out] ITBasicCallControl **ppCall
);

パラメーター

[in] pDestAddress

この BSTR 文字列には宛先アドレスが含まれています。形式はプロバイダー固有です。このポインターは、ダイヤルされていないアドレス (ホットフォンなど) の場合、または ITBasicCallControl::D ial を使用してすべてのダイヤルが実行される場合は NULL にすることができます。 ITBasicCallControl::P ickup の NULLpGroupID と組み合わせて NULL を指定すると、グループピックアップが行われます。逆多重化機能を持つサービスプロバイダーを使用すると、アプリケーションで複数のアドレスを一度に指定できます。

[in] lAddressType

アドレスの形式を表す、LINEADDRESSTYPE_PHONENUMBERなどのアドレス型定数が含まれます。値は、このアドレスに対して有効である必要があります。値を確認するには、ADDRESSCap を AC_ADDRESSTYPES に設定した ITAddressCapabilities::get_AddressCapability を使用します。

[in] lMediaTypes

通話セッションに関係するメディアの種類または種類を識別します。

[out] ppCall

ITBasicCallControl インターフェイスへのポインター。

戻り値

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

値	意味
S_OK	メソッドが成功しました。
E_INVALIDARG	アドレスの種類 lAddressType が無効であるか、複数のアドレスの種類を指定します。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
E_POINTER	ppCall パラメーターが有効なポインターではありません。

注釈

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

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

会議中、転送中、転送操作中など、相談呼び出しとして使用される呼び出しは、このメソッドを使用して作成する必要があります。

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

メモこのメソッドは、TAPI 2 の lineMakeCall と正確には同じではありません。多くの同じ情報を TAPI に提供しますが、 ITBasicCallControl::Connect が呼び出されるまで並列操作は実行されません。