Método ITAddress2::get_Phones (tapi3if.h)

O método get_Phones retorna um ponteiro VARIANT para uma ITCollection de objetos de telefone correspondentes aos dispositivos de telefone que podem ser usados com esse endereço.

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 EnumeratePhones .

Sintaxe

HRESULT get_Phones(
  [out] VARIANT *pPhones
);

Parâmetros

[out] pPhones

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

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 preferencial para um endereço ou conjunto de endereços retornando IDs de endereço/linha por meio de phoneGetID com a classe de dispositivo tapi/line. Se nenhum telefone estiver disponível para uso com o endereço, esse método produzirá uma coleção vazia e retornará S_OK.

TAPI chama o método AddRef na interface ITPhoneretornada por ITAddress2::get_Phones. O aplicativo deve chamar Release na interface ITPhone 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

Confira também

EnumerarPhones

ITAddress2