Método ITAddressTranslation::get_CallingCards (tapi3if.h)

Artigo
03/05/2024

O método get_CallingCards cria uma coleção de cartões de chamada associados ao endereço. Esse método é fornecido para aplicativos cliente de Automação, como aqueles escritos no Visual Basic. Os aplicativos C e C++ devem usar o método EnumerateCallingCards .

Sintaxe

HRESULT get_CallingCards(
  [out] VARIANT *pVariant
);

Parâmetros

[out] pVariant

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

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 pVariant não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.

Comentários

O método get_CallingCards é um wrapper COM para a função TAPI 2.2 LineGetTranslateCaps e usa informações de chamada cartão da estrutura LINETRANSLATECAPS retornada por essa função.

O TAPI chama o método AddRef na interface ITCallingCardretornada por ITAddressTranslation::get_CallingCards. O aplicativo deve chamar Release na interface ITCallingCard para liberar recursos associados a ele.