lineDrop
9/19/2008
Essa função cai ou desconecta o chamar especificado. O aplicativo tem a opção ao usuário especificar - a - usuário dados para serem transmitidos como parte de desconexão chamar.
Syntax
LONG lineDrop(
HCALL hCall,
LPCTSTR lpsUserUserInfo,
DWORD dwSize
);
Parameters
- hCall
[no] Identificador para a chamar para ser descartado. O aplicativo deve ser um proprietário do chamar. O estado chamar de hCall Pode ser qualquer estado, exceto ocioso.
- lpsUserUserInfo
[no] Ponteiro para uma seqüência de caracteres que contém dados usuário a ser enviado para o parte remota como parte de desconexão chamar. Esse ponteiro pode ser deixado NULL se nenhum usuário - a - usuário dados deve ser enviada. Usuário - a - usuário dados é enviado somente se com suporte pela subjacente rede. Para obter mais informações, consulte LINEDEVCAPS. O campo protocolo para o usuário - a - usuário dados, se exigido, deve aparecer como o primeiro byte da reserva apontada pelo lpsUserUserInfoe deve ser contabilizada para in a parâmetro dwSize.
- dwSize
[no] Valor que especifica o tamanho, em bytes, do usuário - a - usuário dados em lpsUserUserInfo. Se lpsUserUserInfo é NULL, nenhum usuário - a - usuário dados é enviado para a parte chamado e dwSize é ignorado.
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 |
Identificador de chamada inválido |
LINEERR_OPERATIONUNAVAIL |
A operação é não disponível. Com divisão codificar múltiplo acessar (CDMA), essa função pode finalizar todas as chamadas ativo. 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_RESOURCEUNAVAIL |
O recurso não está disponível |
LINEERR_INVALPOINTER |
Ponteiro inválido |
LINEERR_NOMEM |
Memória insuficiente |
LINEERR_USERUSERINFOTOOBIG |
O seqüência de caracteres contendo dados usuário é muito grande |
LINEERR_OPERATIONFAILED |
A operação falhou |
LINEERR_INVALCALLSTATE |
Chamada não está no ocioso estado |
LINEERR_NOTOWNER |
Aplicativo não é o proprietário do chamar |
LINEERR_UNINITIALIZED |
O parâmetro é não inicializado |
Remarks
Ao chamar lineDrop, relacionado chamadas às vezes podem ser afetadas bem. De exemplo, descartar um chamar da conferência pode ato de soltar individual todos os participantes chamadas. LINE_CALLSTATE As mensagens são enviadas para o aplicativo para todas as chamadas cujo estado chamar é afetado. Um transições geralmente chamar ignorados para o ocioso estado. Chamando lineDrop Em um chamar in a Oferta estado rejeita a chamar. Nem todas as redes telefônicas fornecem essa funcionalidade.
Um chamar in a onholdpending estado geralmente reverte para o Conectado estado. Ao soltar o chamar auxílio para a terceiros para chamar uma conferência ou ao remover a terceiros em um chamar conferência estabelecida anteriormente, o provedor e alternar, poderá versão a ponte de conferência e reverter a chamar voltar para uma dois normal-parte chamar. Se esse for a maiúsculas e minúsculas, hConfCall Alterna para o ocioso estado e as restante apenas transições chamar participante para o Conectado estado. Alguns alterna versão automaticamente a mantenha na outro chamar.
O aplicativo tem a opção Enviar usuário - a - usuário dados no tempo da ato de soltar. Mesmo se usuário - a - usuário dados pode ser enviado, há não garante que a rede fornecerá este dados para o parte remota.
Em vários Com ponte ou configurações festa-Linha, quando múltiplo partes estiverem na chamar, lineDrop Talvez não realmente Clear a chamar. De exemplo, em uma situação com ponte, um lineDrop operação pode na verdade não ato de soltar a chamar porque o status de outras estações de chamar pode regem; Em vez disso, a chamar pode simplesmente ser alterado para o modo LINECONNECTEDMODE_INACTIVE se ele permanece Conectado Em outras estações.
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 |