Compartilhar via


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

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

IEnumAddress

ITAddress

ITTAPI

Registrar snippet de código de eventos

Objeto TAPI

get_Addresses