lineDeallocateCall
.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 Desaloca o identificador especificado chamar.
Syntax
LONG lineDeallocateCall(
HCALL hCall
);
Parameters
- hCall
[no] Chame identificador a ser desalocada. Um aplicativo com monitoração privilégios para um chamar pode sempre desalocar o identificador para que chamar. Um aplicativo com privilégio proprietário para um chamar pode desalocar o identificador a menos que seja o único proprietário do chamar o chamar em não a ocioso estado. O identificador chamar é não mais válido depois ele tem sido desalocado.
Return Value
Zero indica sucesso. Um número de erro negativa indica que ocorreu 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_INVALCALLSTATE |
Chamada não está no ocioso estado |
LINEERR_NOMEM |
Memória insuficiente |
LINEERR_OPERATIONFAILED |
A operação falhou |
LINEERR_RESOURCEUNAVAIL |
O recurso não está disponível |
LINEERR_UNINITIALIZED |
O parâmetro é não inicializado |
Remarks
A desalocação não afeta o estado chamar do físico chamar. Possuir, no entanto, os recursos internos versão relacionado para o chamar.
Em versões anteriores ao 2.0, se a chamar o aplicativo é o único proprietário de um chamar e não em TAPI o ocioso estado, LINEERR_INVALCALLSTATE é retornado. Neste maiúsculas e minúsculas, o aplicativo pode primeiro ato de soltar a chamar usando o lineDrop função e desalocar o identificador chamar posteriormente. Um aplicativo que tenha privilégio monitor para um chamar pode sempre desalocar o identificador para a chamar.
Observação
Saiba que deixar o chamar sem um proprietário pode resultar no usuário sendo Não é possível finalizar o chamar se não houver monitoração aberto aplicativos impedindo chamado TAPI TSPI_lineCloseCall.Use este recurso somente se o aplicativo pode determinar que o chamar pode ser controlada externamente, o usuário.
Quando o lineDeallocateCall função Desaloca um identificador chamar, ele também suspende processamento adicional de qualquer pendente LINE_REPLY mensagens para o chamar. Um aplicativo deve ser criado Não Para aguardar indefinidamente mensagens LINE_REPLY para cada correspondente chamar para um assíncrono função se ele também usa o lineDeallocateCall função para desalocar alças.
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 |