Método ITBasicCallControl::P arkDirect (tapi3if.h)

Artigo
08/26/2023

O método ParkDirect estaciona a chamada em um endereço especificado.

Sintaxe

HRESULT ParkDirect(
  [in] BSTR pParkAddress
);

Parâmetros

[in] pParkAddress

Ponteiro para BSTR que contém o endereço em que a chamada deve estar estacionada.

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_POINTER	O parâmetro pParkAddress não é um ponteiro válido.
E_FAIL	Não há suporte para Park.
E_INVALIDARG	O parâmetro pParkAddress não é válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
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.

Com o parque direcionado, o aplicativo determina o endereço no qual deseja estacionar a chamada. Com o ParkInDirect, a opção determina o endereço e fornece isso ao aplicativo. Em ambos os casos, uma chamada estacionada pode ser desmarcada especificando esse endereço.

A chamada estacionada entra no estado desconectado depois de ter sido estacionada com êxito.

Algumas opções podem lembrar o usuário depois que uma chamada estiver estacionada por um longo período de tempo. O aplicativo vê uma chamada de oferta com um motivo de chamada definido como lembrete.

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pParkAddress e usar SysFreeString para liberar a memória quando a variável não for mais necessária.