Método ITPhone::get_Addresses (tapi3if.h)
O método get_Addresses retorna uma coleção de endereços em que o telefone pode ser usado. 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. Em vez disso, os aplicativos C/C++ devem usar o método EnumerateAddresses .
Sintaxe
HRESULT get_Addresses(
[out] VARIANT *pAddresses
);
Parâmetros
[out] pAddresses
Ponteiro para um VARIANT que contém uma ITCollection de ponteiros de interface ITAddress .
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Um dispositivo de telefone se declara disponível em todos os endereços que dão suporte a terminais de áudio pela configuração tsp do PHONEFEATURE_GENERICPHONE bit no membro dwPhoneFeatures da estrutura PHONECAPS . Um dispositivo de telefone também pode se declarar como preferencial para um endereço ou conjunto de endereços retornando IDs de endereço/linha usando phoneGetID com a classe de dispositivo tapi/line. O método get_Addresses retorna endereços que foram identificados de ambas as maneiras.
Para obter apenas os endereços em que o telefone é preferencial, você pode chamar o método get_PreferredAddresses .
O aplicativo não precisa chamar o método ITPhone::Open antes de chamar get_Addresses. 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_Addresses. O aplicativo deve chamar Release na interface ITAddress para liberar recursos associados a ele.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi3if.h (inclua Tapi3.h) |
| Biblioteca | Uuid.lib |
| DLL | Tapi3.dll |