itAddress::get_DialableAddress 方法 (tapi3if.h)

get_DialableAddress 方法获取可用于连接到此地址的 BSTRBSTR 对应于另一个应用程序将用于连接到此地址的目标地址字符串,例如电话号码或电子邮件名称。

语法

HRESULT get_DialableAddress(
  [out] BSTR *pDialableAddress
);

参数

[out] pDialableAddress

指向包含可拨号地址字符串的 BSTR 的指针。 这将匹配 ITAddress::CreateCall 的 pDestAddress 参数。

返回值

此方法可以返回其中一个值。

含义
S_OK
方法成功。
E_OUTOFMEMORY
内存不足,无法执行操作。
E_POINTER
pDialableAddress 参数不是有效的指针。

注解

应用程序必须使用 SysFreeString 来释放为 pDialableAddress 参数分配的内存。

此值的可用性取决于服务提供程序。 例如,在 Unimodem 服务提供程序公开的地址上,此方法将返回空字符串而不是电话号码。

要求

   
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

Address 对象

可拨号地址

ITAddress

ITAddress::CreateCall