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

Artigo
03/02/2024

O método EnumerateAddresses enumera os endereços que estão disponíveis no momento. Fornecido para aplicativos C e C++. Aplicativos cliente de automação, como aqueles escritos no Visual Basic, devem usar o método get_Addresses .

Sintaxe

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

Parâmetros

[out] ppEnumAddress

Ponteiro para a interface IEnumAddress .

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 ppEnumAddress não é um ponteiro válido.
E_INVALIDARG	O objeto TAPI não foi inicializado.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.

Comentários

Um aplicativo normalmente usa essa enumeração para marcar os recursos de cada endereço e determinar quais são úteis para fins atuais.

Se um endereço esperado não for encontrado, isso poderá indicar que o provedor de serviços apropriado não foi instalado ou não está funcionando corretamente.

O TAPI chama o método Addref na interface IEnumAddress retornada por ITTAPI::EnumerateAddresses. O aplicativo deve chamar o método Release na interface IEnumAddress para liberar recursos associados a ele.

Se um endereço for criado ou removido durante uma sessão TAPI, o aplicativo será notificado por meio da interface ITTAPIEventNotification . Se um endereço tiver sido criado, como instalando um dispositivo Plug and Play, ITTAPIEventNotification::Event retornará o TE_ADDRESSCREATE membro da enumeração TAPIOBJECT_EVENT. Se um endereço for removido, ITTAPIEventNotification::Event retornará TE_ADDRESSREMOVE. Chamar EnumerateAddresses após esses eventos refletirá os endereços atuais.