Função linePrepareAddToConferenceW (tapi.h)

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

Sintaxe

LONG linePrepareAddToConferenceW(
  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 ser 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 pode ser definido como NULL se nenhum parâmetro de configuração de chamada especial for desejado.

Valor de retorno

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 LINE_REPLY correspondente é 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.

Observações

Se LINEERR_INVALLINESTATE for retornado, a linha não está 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 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.

Nota

O cabeçalho tapi.h define linePrepareAddToConference como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

Visão geral da Conferência

LINECALLPARAMS

LINEDEVSTATUS

LINE_REPLY

Funções de serviço de linha suplementar

lineAddToConference

lineCompleteTransfer

lineDrop

lineGetLineDevStatus

lineSetupConference

lineSwapHold