Compartilhar via

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

  • Artigo

O método get_PreferredPhones retorna uma coleção de objetos de telefone correspondentes aos dispositivos de telefone que são preferenciais para uso com esse endereço.

Esse método destina-se ao Visual Basic e aos aplicativos de script. Em vez disso, os aplicativos C/C++ devem usar o método EnumeratePreferredPhones .

Sintaxe

HRESULT get_PreferredPhones(
  [out] VARIANT *pPhones
);

Parâmetros

[out] pPhones

Ponteiro para um VARIANT que contém uma ITCollection de ponteiros de interface ITPhone .

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 pPhones não é um ponteiro válido.
E_OUTOFMEMORY
 Não há memória suficiente para alocar o objeto de coleçã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 esse endereço, o método produzirá uma coleção vazia e retornará S_OK.

O TAPI chama o método AddRef na interface ITPhoneretornada por ITAddress2::get_PreferredPhones. O aplicativo deve chamar Release na interface do ITPhone 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

Confira também

ITAddress2

ITPhone