ITAddressCapabilities：：get_AddressCapabilityString 方法 (tapi3if.h)

get_AddressCapabilityString 方法會取得指定ADDRESS_CAPABILITY_STRING的功能字串。

語法

HRESULT get_AddressCapabilityString(
  [in]  ADDRESS_CAPABILITY_STRING AddressCapString,
  [out] BSTR                      *ppCapabilityString
);

[in] AddressCapString

所需位址功能字串的描述項。

[out] ppCapabilityString

位址功能的 BSTR 值指標。如果 TSP 未提供 AddressCapString 的值，則 NULL 是可能的傳回值。

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	方法成功。
E_INVALIDARG	AddressCapString 參數無效。
E_POINTER	ppCapabilityString 參數不是有效的指標。
TAPI_E_NOTSUPPORTED	TAPI 版本不是 3.0 或更高版本。
E_OUTOFMEMORY	記憶體不足，無法執行作業。

應用程式必須使用 SysFreeString 來釋放配置給 ppCapabilityString 參數的記憶體。