Método ITBasicCallControl::Hold (tapi3if.h)

Artigo
08/26/2023

O método Hold coloca ou remove a chamada da retenção.

Sintaxe

HRESULT Hold(
  [in] VARIANT_BOOL fHold
);

Parâmetros

[in] fHold

Se fHold for VARIANT_TRUE e o método for bem-sucedido, o estado de chamada fará a transição para o estado CS_HOLD. Se fHold for VARIANT_FALSE, o estado de chamada fará a transição para CS_CONNECTED.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
TAPI_E_INVALCALLSTATE	A chamada associada a essa interface não existe mais.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos

Comentários

Alguns provedores de serviços não dão suporte a essa operação enquanto o streaming está ativo. O aplicativo pode precisar chamar ITStream::StopStream ou ITSubStream::StopSubStream antes da operação e ITStream::StartStream ou ITSubStream::StartSubStream após a conclusão da operação.