ITAddress：：CreateCall 方法 (tapi3if.h)

项目
08/26/2023

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。 NULL 与 ITBasicCallControl：:P ickup 中的 NULLpGroupID 结合使用会导致组选取。具有反多路复用功能的服务提供商可以允许应用程序一次指定多个地址。

[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 参数不是有效的指针。