Compartilhar via

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

  • Artigo

O método EnumeratePreferredPhones enumera os objetos de telefone preferenciais para 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_PreferredPhones .

Sintaxe

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

Parâmetros

[out] ppEnumPhone

Ponteiro para o local em que, com êxito, esse método colocará um ponteiro para um objeto de enumeração que contém a lista retornada de telefones.

Valor retornado

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
 Não há memória suficiente para alocar o objeto de enumeração.

Comentários

Um dispositivo de telefone se declara 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::EnumeratePreferredPhones. O aplicativo deve chamar Release na interface IEnumPhone para liberar recursos associados a ele.

Requisitos

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

Confira também

IEnumPhone

ITAddress2