Função linePrepareAddToConference (tapi.h)

Artigo
03/02/2024

A função linePrepareAddToConference prepara uma chamada de conferência existente para a adição de outra parte.

Sintaxe

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parâmetros

hConfCall

Manipule para uma chamada em conferência. O aplicativo deve ser um proprietário dessa chamada. O estado de chamada de hConfCall deve estar conectado.

lphConsultCall

Ponteiro para um identificador HCALL. Esse local é carregado com um identificador que identifica a chamada de consulta a ser adicionada. Inicialmente, o aplicativo é o único proprietário dessa chamada.

lpCallParams

Ponteiro para uma estrutura LINECALLPARAMS que contém parâmetros de chamada a serem usados ao estabelecer a chamada de consulta. Esse parâmetro poderá ser definido como NULL se nenhum parâmetro de configuração de chamada especial for desejado.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

Comentários

Se LINEERR_INVALLINESTATE for retornado, a linha não estará atualmente em um estado no qual essa operação pode ser executada. Uma lista de operações válidas no momento pode ser encontrada no membro dwLineFeatures (do tipo LINEFEATURE) na estrutura LINEDEVSTATUS . (Chamar lineGetLineDevStatus atualiza as informações em LINEDEVSTATUS.)

Um identificador de chamada de conferência pode ser obtido com lineSetupConference ou com lineCompleteTransfer que é resolvido como uma chamada de conferência de três vias. A função linePrepareAddToConference normalmente coloca a chamada de conferência existente no estado onHoldPendingConference e cria uma chamada de consulta que pode ser adicionada posteriormente à chamada de conferência existente com lineAddToConference.

A chamada de consulta pode ser cancelada usando lineDrop. Também pode ser possível que um aplicativo troque entre a chamada de consulta e a chamada em conferência realizada com lineSwapHold.