ITAddress::get_DialableAddress method (tapi3if.h)
The get_DialableAddress method 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.
Syntax
HRESULT get_DialableAddress(
[out] BSTR *pDialableAddress
);
Parameters
[out] pDialableAddress
Pointer to BSTR containing the dialable address string. This will match the pDestAddress argument of ITAddress::CreateCall.
Return value
This method can return one of these values.
| Value | Meaning |
|---|---|
|
Method succeeded. |
|
Insufficient memory exists to perform the operation. |
|
The pDialableAddress parameter is not a valid pointer. |
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
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |
| Library | Uuid.lib |
| DLL | Tapi3.dll |