ITAddress::get_ServiceProviderName method (tapi3if.h)
The get_ServiceProviderName method gets the name of the Telephony Service Provider (TSP) that supports this address: for example, Unimdm.tsp for the Unimodem service provider or H323.tsp for the H323 service provider.
Syntax
HRESULT get_ServiceProviderName(
[out] BSTR *ppName
);
Parameters
[out] ppName
Pointer to BSTR containing the service provider name.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
Method succeeded. |
|
The ppName parameter is not a valid pointer. |
|
Insufficient memory exists to perform the operation. |
|
No service provider was found that supports the current address. |
Remarks
The application must use SysFreeString to free the memory allocated for the ppName parameter.
You can retrieve the name of the provider in a TSP-dependent format using ITAddressCapabilities::get_AddressCapabilityString with AddressCapString set to ACS_PROVIDERSPECIFIC, which returns the string found in the dwProviderInfoOffset member of the TAPI 2.x LINEDEVCAPS structure.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |
| Library | Uuid.lib |
| DLL | Tapi3.dll |