lineAccept
.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 aceita a chamar oferecida especificado. Opcionalmente, ele pode enviar o usuário especificado-informações usuário para a parte chamado.
Syntax
LONG WINAPI lineAccept(
HCALL hCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
Parameters
- hCall
Identificador para a chamar para ser aceita. O aplicativo deve ser um proprietário do chamar. Estado de chamada hCall Deve ser oferecendo.
- lpsUserUserInfo
Ponteiro para uma seqüência de caracteres contendo usuário-usuário informações sejam enviadas para o parte remota como parte de aceitar chamar. Esse ponteiro pode ser deixado NULL se nenhum usuário-usuário informações é a ser enviado. Usuário-informações usuário só são enviados se com suporte pela subjacente (consulte rede LINEDEVCAPS). O membro discriminador protocolo para o usuário-informações usuário, se exigido, deve aparecer como o primeiro byte da reserva apontada pelo lpsUserUserInfoe deve ser contabilizada para in a dwSize parâmetro.
- dwSize
Tamanho, em bytes, do usuário-usuário informações em lpsUserUserInfo. Se lpsUserUserInfo é NULL, nenhum usuário-usuário informações são enviadas 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 tiver êxito, 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 chamar é inválido. |
LINEERR_RESOURCEUNAVAIL |
O recurso não está disponível. |
LINEERR_INVALCALLSTATE |
O estado chamar é inválido. |
LINEERR_NOTOWNER |
O aplicativo não é o proprietário do chamar. |
LINEERR_UNINITIALIZED |
O parâmetro é não inicializado. |
LINEERR_INVALPOINTER |
O ponteiro é inválido. |
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 irá falhar se um chamar está em andamento. 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_NOMEM |
Não há memória o suficiente disponível. |
LINEERR_USERUSERINFOTOOBIG |
O usuário-informações usuário é muito grandes. |
Remarks
O lineAccept função é usada em ambientes telefonia, como rede digital de serviços integrados (ISDN) que permitem alerta associado com de entrada chamadas para ser separar a partir de oferta inicial do chamar. Quando um chamar vem em, ele primeiro é oferecido. Para alguns pequena quantidade de tempo, o aplicativo pode ter a opção rejeitar a chamar usando o lineDrop função, redirecione a chamar a outra estação usar o lineRedirect função, resposta ao chamar usando o lineAnswer função, ou aceitar a chamar usando lineAccept. Depois que um chamar tem sido com êxito aceito por um aplicativo, alerta começa em tanto o chamado dispositivo chamado e o estado chamar transições geralmente aceito.
Alerta é relatado para o aplicativo pela LINE_LINEDEVSTATE mensagem com a indicação toque.
O lineAccept função também pode ser com suporte por provedores serviço non-ISDN. O estado chamar transição para aceita pode ser usada por outros aplicativos como uma indicação que outro aplicativo tenha solicitado responsabilidade para o chamar e tiver apresentado a chamar para o usuário.
O aplicativo tem a opção Enviar usuário-usuário informações no tempo da aceitar. Mesmo usuário-usuário informações são enviadas, haverá não garante que a rede fornecerá este informações para a parte chamado. Um aplicativo deve consultar recursos dispositivo de uma linha para determinar se chamar aceitar está disponível.
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 |