linePickup
9/19/2008
Essa função pega um alerta chamar no endereço de destino especificado e retorna um identificador chamar para chamar a picked-UP. Se chamado com NULL para a lpszDestAddress parâmetro, uma retirada GRUPO é executado. Se exigido pelo dispositivo, o lpszGroupID parâmetro especifica o identificador GRUPO ao qual a estação de alerta pertence.
Syntax
LONG WINAPI linePickup(
HLINE hLine,
DWORD dwAddressID,
LPHCALL lphCall,
LPCSTR lpszDestAddress,
LPCSTR lpszGroupID
);
Parameters
- hLine
Identificador para o aberto dispositivo de linha na qual um chamar está para ser capturada.
- dwAddressID
Endereço no hLine no qual a retirada é ser se originou. Um identificador endereço permanentemente é associado com um endereço; o identificador permanece constante entre atualizações sistema operacional.
- lphCall
Ponteiro para uma localidade memória onde o identificador para a chamar separado Backup será retornado. O aplicativo é o único proprietário inicial do chamar.
- lpszDestAddress
Ponteiro para uma reserva caractere NULL-Terminated que contém o endereço cujo chamar é para ser capturada. O endereço está na padrão formato endereço discável.
lpszGroupID
Ponteiro para uma reserva caractere NULL-Terminated que contém o identificador GRUPO ao qual a estação de alerta pertence. Este parâmetro é exigido em algumas opções para escolher até chamadas outside of o atual GRUPO retirada.O lpszGroupID parâmetro pode ser especificado pelo próprio com um NULL ponteiro para lpszDestAddress. Como alternativa, lpszGroupID Pode ser especificada além de lpszDestAddress, se exigido pelo dispositivo.
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_INVALADDRESS |
O endereço é inválido. |
LINEERR_NOMEM |
Não há memória o suficiente disponível. |
LINEERR_INVALADDRESSID |
O identificador endereço é inválido. |
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_INVALGROUPID |
O identificador GRUPO é inválido. |
LINEERR_OPERATIONFAILED |
A operação falhou. |
LINEERR_INVALLINEHANDLE |
O identificador para o aberto linha dispositivo é inválido. |
LINEERR_RESOURCEUNAVAIL |
Os recursos são não disponível. |
LINEERR_INVALPOINTER |
O ponteiro é inválido. |
LINEERR_UNINITIALIZED |
Um parâmetro é não inicializado. |
Remarks
Quando um chamar tem sido captado com êxito, o aplicativo é notificado pelo LINE_CALLSTATE mensagem sobre estado chamar altera. O LINECALLINFO estrutura fornece informações sobre o chamar que foi capturada. Ele lista os motivos para a chamar como retirada. Essa estrutura está disponível usando o lineGetCallInfo função.
Se for TRUE, LINEADDRCAPFLAGS_PICKUPCALLWAIT linePickup Pode ser usado para escolher até um chamar para os quais o usuário audibly detectou o sinal de chamada em espera, mas para o qual o provedor não consegue executar a detecção. Isso oferece um mecanismo para o usuário resposta um chamar de espera até embora pôde provedor de serviço de detecção de Call-Waiting sinal. Ambos lpszDestAddress e lpszGroupID ponteiro parâmetros devem ser NULL para escolher até um chamar Call-Waiting. O linePickup função cria um novo identificador chamar para chamar a espera e passa esse identificador para o usuário. O dwAddressID parâmetro é mais freqüentemente zero (principalmente em casos residenciais single-line).
Após linePickup foi usado para escolher até chamar o segundo, o lineSwapHold função pode ser usada para alternar entre eles. O lineDrop função pode ser usada para ato de soltar um (e alternar para o outro), e assim por diante. Se o usuário deseja ato de soltar o atual chamar e escolher até o segundo chamar, eles devem chamar lineDrop Quando eles get o bipe Call-Waiting, aguardar a chamar segundo para anel e em seguida, chamar o lineAnswer função sobre o novo identificador chamar. O sinalizador LINEADDRFEATURE_PICKUP in a dwAddressFeatures membro no LINEADDRESSSTATUS indica quando retirada é realmente possí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 |
See Also
Reference
LINE_CALLSTATE (TAPI)
LINE_REPLY
lineAnswer
LINECALLINFO
lineDrop
lineGetCallInfo
lineSwapHold