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.

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

See Also

Reference

LINE_CALLSTATE (TAPI)
LINE_REPLY
LINEDEVCAPS