Compartilhar via

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

  • Artigo

O método EnumeratePhones enumera os objetos de telefone correspondentes aos dispositivos de telefone que podem ser usados com esse endereço.

Esse método destina-se a aplicativos C/C++. O Visual Basic e os aplicativos de script devem usar o método get_Phones .

Sintaxe

HRESULT EnumeratePhones(
  [out] IEnumPhone **ppEnumPhone
);

Parâmetros

[out] ppEnumPhone

Ponteiro para a nova interface IEnumPhone .

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 ppEnumPhone não é um ponteiro válido.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.
E_UNEXPECTED
 O método falhou por motivos desconhecidos.

Comentários

Um dispositivo de telefone se declara disponível em todos os endereços que dão suporte a terminais de áudio pelo TSP definindo o bit PHONEFEATURE_GENERICPHONE 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. Se nenhum telefone estiver disponível para uso com o endereço, esse método produzirá uma enumeração vazia e retornará S_OK.

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

IEnumPhone

ITAddress2