Compartilhar via


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

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 .

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Objeto Address

ITAddress

ITAddressCapabilities::get_AddressCapabilityString

LINEDEVCAPS