| Platform SDK: TAPI |
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.
HRESULT get_ServiceProviderName( BSTR *ppName );
| Value | Meaning |
|---|---|
| S_OK | Method succeeded. |
| E_POINTER | The ppName parameter is not a valid pointer. |
| E_OUTOFMEMORY | Insufficient memory exists to perform the operation. |
| TAPI_E_NODRIVER | No service provider was found that supports the current address. |
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.
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.
ITAddress, Address Object, ITAddressCapabilities::get_AddressCapabilityString, LINEDEVCAPS