lineClose
9/19/2008
Essa função fecha o aberto especificado dispositivo de linha.
Syntax
LONG lineClose(
HLINE hLine
);
Parameters
- hLine
[no] Identificador para o aberto dispositivo de linha a ser fechado. Após a linha foi fechada com êxito, esse identificador é não mais válido.
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_INVALLINEHANDLE |
Identificador inválido fornecido |
LINEERR_NOMEM |
Não há memória disponível |
LINEERR_OPERATIONFAILED |
A operação falhou |
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_UNINITIALIZED |
O parâmetro é não inicializado |
Remarks
Se um aplicativo chama lineClose enquanto ele ainda tem ativo chamadas na linha aberta, a propriedade do aplicativo dessas chamadas for revogado. Se o aplicativo possui essas chamadas, as chamadas serão ignoradas bem. É uma prática boa programação para um aplicativo para descartar das chamadas que ele possui em um aberto linha por explicitamente abandonar posse e / ou por descartando essas chamadas anteriores para fechar a linha.
Se a linha foi fechada com êxito, um LINE_LINEDEVSTATE mensagem é enviada para todos os aplicativos monitoração o status de linha para aberto/fechar alterações. Assíncrono pendente respostas são suprimidas.
Provedores de serviço podem localizar úteis ou necessários para dispositivos de linha recuperar forçosamente de um aplicativo que tenha aberto a linha. Isso pode ser útil para evitar um aplicativo de monopolizando o dispositivo de linha. Se isso acontecer, um LINE_CLOSE mensagem é enviada para o aplicativo, especificando o identificador de linha de dispositivo de linha que foi fechado.
O lineOpen função aloca recursos para o aplicativo chamado, e aplicativos podem ser impedidos de abrir uma linha se forem recursos não disponível. Portanto, um aplicativo que usa um dispositivo de linha, apenas ocasionalmente such as para de saída fazendo chamadas, deve fechar a Linha livre recursos e habilitar outro aplicativos para aberto a linha.
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 |