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

Artigo
03/02/2024

O método ParkIndirect estaciona a chamada e retorna o endereço estacionado.

Sintaxe

HRESULT ParkIndirect(
  [out] BSTR *ppNonDirAddress
);

Parâmetros

[out] ppNonDirAddress

Ponteiro para uma representação BSTR do endereço onde a chamada estava estacionada.

Retornar valor

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 ppNonDirAddress não é um ponteiro válido.
E_FAIL	Não há suporte para park.
E_INVALIDARG	O parâmetro ppNonDirAddress não é válido.
E_OUTOFMEMORY	Existe 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 ParkDirect, o aplicativo determina o endereço no qual deseja estacionar a chamada. Com o parque não redirecionado, 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 SysFreeString para liberar a memória alocada para o parâmetro ppNonDirAddress .