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

O método EnumerateAddresses enumera os endereços nos quais o telefone pode ser usado. O aplicativo não precisa chamar ITPhone::Open antes de executar esse método.

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

Sintaxe

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parâmetros

[out] ppEnumAddress

Ponteiro para a interface IEnumAddress .

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

Se nenhum telefone estiver disponível para uso com o endereço, esse método produzirá uma enumeração vazia e retornará S_OK.

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 EnumerateAddresses 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 EnumeratePreferredAddresses .

Um dispositivo de telefone se declara específico para um endereço ou conjunto de endereços retornando IDs de endereço/linha usando phoneGetID 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 EnumerateAddresses. 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 IEnumAddress retornada por ITPhone::EnumerateAddresses. O aplicativo deve chamar Release na interface IEnumAddress para liberar recursos associados a ele.

Requisitos

Confira também

EnumeratePreferredAddresses

ITPhone