ITAddress::get_DialableAddress

Gets the BSTR which can be used to connect to this address. The BSTR corresponds to the destination address string that another application would use to connect to this address, such as a phone number or an e-mail name.

HRESULT get_DialableAddress(
  BSTR *pDialableAddress
);

Parameters

pDialableAddress

[out, retval] Pointer to BSTR containing the dialable address string. This will match the pDestAddress argument of ITAddress::CreateCall.

Return Values

Remarks

The application must use SysFreeString to free the memory allocated for the pDialableAddress parameter.

The availability of this value depends on the service provider. For example, on an address exposed by the Unimodem service provider, this method will return an empty string instead of a phone number.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITAddress, ITAddress::CreateCall, Address Object, Dialable Addresses