Método ITPhone::EnumerateTerminals (tapi3if.h)
O método EnumerateTerminals recupera uma enumeração de terminais associados ao telefone. O aplicativo não precisa chamar ITPhone::Open antes de executar esse método.
Sintaxe
HRESULT EnumerateTerminals(
[in] ITAddress *pAddress,
[out] IEnumTerminal **ppEnumTerminal
);
Parâmetros
[in] pAddress
Ponteiro para a interface ITAddress .
[out] ppEnumTerminal
Ponteiro para a interface IEnumTerminal que enumera terminais.
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 terminal estiver associado ao telefone, esse método produzirá uma enumeração vazia e retornará S_OK.
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 EnumerateTerminals. 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 IEnumTerminal retornada por ITPhone::EnumerateTerminals. O aplicativo deve chamar Release na interface IEnumTerminal 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 |