Método ITPhone::get_PreferredAddresses (tapi3if.h)

Artigo
03/05/2024

O método get_PreferredAddresses retorna uma coleção de endereços em que o telefone é preferencial para uso. O aplicativo não precisa chamar ITPhone::Open antes de executar esse método.

Esse método destina-se ao Visual Basic e aos aplicativos de script. Os aplicativos C/C++ acharão mais conveniente usar o método EnumerateAddresses .

Sintaxe

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

Parâmetros

[out] pAddresses

Ponteiro para uma VARIANT que contém uma ITCollection de ponteiros de interface ITAddress .

Retornar valor

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pAddresses não é um ponteiro válido.
E_OUTOFMEMORY	Não há memória suficiente para alocar o objeto de coleção.

Comentários

Se nenhum endereço utilizável estiver presente no sistema, esse método retornará uma coleção vazia.

Um dispositivo de telefone se declara preferencial para um endereço ou conjunto de endereços retornando IDs de endereço/linha usando a função phoneGetID TAPI 2.x com a classe de dispositivo tapi/line.

Embora a função phoneGetID exija o identificador para um dispositivo de telefone aberto, o aplicativo não precisa chamar o método ITPhone::Open antes de chamar EnumeratePreferredAddresses. Isso ocorre porque a implementação do objeto de telefone pode abrir o telefone e chamar phoneGetID durante a inicialização do TAPI ou quando um novo objeto de telefone é exibido.

O TAPI chama o método AddRef na interface ITAddress retornada por ITPhone::get_PreferredAddresses. O aplicativo deve chamar Release na interface ITAddress para liberar recursos associados a ele.