lineCompleteTransfer
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/19/2008
Essa função conclui a transferir do chamar especificado para a parte conectado na chamar auxílio.
Syntax
LONG WINAPI lineCompleteTransfer(
HCALL hCall,
HCALL hConsultCall,
LPHCALL lphConfCall,
DWORD dwTransferMode
);
Parameters
- hCall
Identificador para a chamar a ser transferido. O aplicativo deve ser um proprietário deste chamar. O estado chamar de hCall Deve ser onHold ou onHoldPendingTransfer.
- hConsultCall
Identificador para a chamar que representa uma conexão com o destino da transferir. O aplicativo deve ser um proprietário deste chamar. O estado chamar de hConsultCall deve estar conectado, ringback, ocupado, ou Continuar.
- lphConfCall
Ponteiro para uma localidade memória onde um hCall identificador pode ser retornado. Se dwTransferMode é LINETRANSFERMODE_CONFERENCE, chamar a conferência recém-criado é retornado no lphConfCall e o aplicativo se tornará o proprietário único de chamar a conferência. Caso contrário, este parâmetro é ignorado pelo TAPI.
- dwTransferMode
Especifica como a solicitação transferir iniciadas deve ser resolvido. Este parâmetro usa um do LINETRANSFERMODE Constantes.
Return Value
Retorna um identificador positivo solicitação se a função for de forma assíncrona concluída, ou um número negativo erro se ocorrer um erro. O dwParam2 parâmetro do correspondente LINE_REPLY mensagem será zero se a função é bem-sucedida ou é um número negativo erro se ocorrer um erro. A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
LINEERR_INVALCALLHANDLE |
O identificador para a chamar a serem transferidas é inválido. |
LINEERR_NOTOWNER |
O aplicativo não é o proprietário deste chamar. |
LINEERR_INVALCALLSTATE |
O estado chamar de hCall Não é onHold ou onHoldPendingTransfer. |
LINEERR_INVALCONSULTCALLHANDLE |
O identificador para a chamar que representa uma conexão com o destino da transferir. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_OPERATIONUNAVAIL |
A operação é não disponível porque esta função não é com suporte por divisão codificar múltiplo acessar (CDMA). CDMA não fornece a funcionalidade necessária para suporte a seguinte funções TAPI:
Alguns portadoras celular fornecem equivalente funcionalidade através de memória flash recurso, que com TAPI 2.2 pode ser acessado com a função lineGenerateDigits. Porque o memória flash exata seqüências controladas por provedores de celular, o aplicativo deve estar completamente ciente dos códigos necessários implementados por provedores de celular. |
LINEERR_INVALTRANSFERMODE |
O modo transferir é inválido. |
LINEERR_RESOURCEUNAVAIL |
Os recursos são não disponível. |
LINEERR_INVALPOINTER |
O ponteiro é inválido. |
LINEERR_UNINITIALIZED |
Um parâmetro é não inicializado. |
LINEERR_NOMEM |
Não há memória o suficiente disponível. |
Remarks
A mensagem LINE_REPLY enviada em resposta a uma chamar para o lineCompleteTransfer função se baseia o status do chamar especificado pelo hCall parâmetro.
Essa operação conclui a transferir do original chamar, hCall, para a parte atualmente conectado por hConsultCall. A chamar consultoria é geralmente discado na chamar consultoria alocado como parte de lineSetupTransfer função, mas ele pode ser qualquer chamar aos quais o alternar é capaz de transferir hCall.
A solicitação transferir pode ser resolvida como um transferir ou chamar uma conferência three-Way. Quando resolvida como um transferir, as partes conectados por hCall e hConsultCall está conectado entre si e ambos hCall e hConsultCall são geralmente desmarcada de linha e transição do aplicativo para o ocioso estado. Chamar identificador permanecerá válido do aplicativo depois de transferir for concluída. O aplicativo deve desalocar o identificador com o lineDeallocateCall função.
Quando resolvido como uma conferência, todas as três partes inserir em uma conferência chamar. Ambas as alças chamar existentes permanecem válido mas transição para o estado conferenced. Um identificador chamar da conferência é criado e retornado, e ele faz a transição para o estado conectado.
Se a pasta lineGetConfRelatedCalls função é chamado imediatamente após lineCompleteTransfer Com o resultado que as chamadas são conferenced, lineGetConfRelatedCalls não pode retornar um lista completa de relacionado chamadas. Isso ocorre porque TAPI aguarda para receber uma mensagem LINE_CALLSTATE indicando que a chamar entrou LINECALLSTATE_CONFERENCED antes de que considera a chamar realmente fazer parte da conferência. Ou seja, ele aguarda provedor de serviço para confirmar o estado conferenced. Depois que o aplicativo foi recebida a mensagem LINE_CALLSTATE, lineGetConfRelatedCalls completo retorna informações.
Ele também pode ser possível executar um transferir portador de deficiência visual de um uso chamar lineBlindTransfer.
Observação
Essa função é TAPI versão 2.0 e posterior.
Requirements
| Header | tapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
lineBlindTransfer
lineDeallocateCall
lineGetConfRelatedCalls
lineSetupTransfer
LINE_CALLSTATE (TAPI)
LINE_REPLY