lineHold
.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
Esta função coloca o chamar especificado em espera.
Syntax
LONG WINAPI lineHold(
HCALL hCall
);
Parameters
- hCall
Identificador para a chamar ser colocado na espera. O aplicativo deve ser um proprietário do chamar. O estado chamar de hCall deve estar conectado.
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 ser colocado na espera é inválido. |
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_INVALCALLSTATE |
O estado chamar de hCall é algo diferente conectado. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_NOMEM |
Não há memória o suficiente disponível. |
LINEERR_RESOURCEUNAVAIL |
Os recursos são não disponível. |
LINEERR_NOTOWNER |
O aplicativo não é o proprietário deste chamar. |
LINEERR_UNINITIALIZED |
Um parâmetro é não inicializado. |
Remarks
O chamar em espera está temporariamente desconectado permitindo que o aplicativo para usar o dispositivo de linha para Fazer ou responder outras chamadas. O lineHold função realiza uma que "rígida mantenha" Do chamar especificado (as opposed to um " chamar consultoria)". Um chamar em espera rígida geralmente não podem ser transferidas ou incluídos no chamar uma conferência, mas um chamar consultoria pode. Chamadas consultoria sejam iniciadas usando o lineSetupTransfer, lineSetupConference, ou linePrepareAddToConference funções.
Após um chamar foi colocado com êxito em mantenha, o estado chamar transições geralmente para onHold. Um chamar mantida é recuperada pela lineUnhold função. Enquanto um chamar estiver em espera, o aplicativo pode receber LINE_CALLSTATE As mensagens sobre estado altera do chamar mantida. Para exemplo, se a parte mantida desliga, o estado chamar possível transição para desconectada.
Em uma situação com ponte, um lineHold operação pode possivelmente não realmente local a chamar em espera, porque o status de outras estações de chamar pode regem (por exemplo, tentar "Mantenha" Um chamar quando outras estações estão participando não é ser possível); Em vez disso, a chamar pode simplesmente ser alterado para o modo LINECONNECTEDMODE_INACTIVE se ele permanece conectado em outras estações.
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
linePrepareAddToConference
lineSetupConference
lineSetupTransfer
lineUnhold
LINE_CALLSTATE (TAPI)