Método ITAddress::get_ServiceProviderName (tapi3if.h)

Artigo
08/26/2023

O método get_ServiceProviderName obtém o nome do TSP (Provedor de Serviços de Telefonia) que dá suporte a esse endereço: por exemplo, Unimdm.tsp para o provedor de serviços Unimodem ou H323.tsp para o provedor de serviços H323.

Sintaxe

HRESULT get_ServiceProviderName(
  [out] BSTR *ppName
);

Parâmetros

[out] ppName

Ponteiro para BSTR que contém o nome do provedor de serviços.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro ppName não é um ponteiro válido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
TAPI_E_NODRIVER	Nenhum provedor de serviços foi encontrado que dê suporte ao endereço atual.

Comentários

O aplicativo deve usar SysFreeString para liberar a memória alocada para o parâmetro ppName .

Você pode recuperar o nome do provedor em um formato dependente de TSP usando ITAddressCapabilities::get_AddressCapabilityString com AddressCapString definido como ACS_PROVIDERSPECIFIC, que retorna a cadeia de caracteres encontrada no membro dwProviderInfoOffset do TAPI 2. estrutura xLINEDEVCAPS .