função TSPI_lineUnpark (tspi.h)
A função TSPI_lineUnpark recupera a chamada estacionada no endereço especificado e retorna um identificador de chamada para ela.
Sintaxe
LONG TSPIAPI TSPI_lineUnpark(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwAddressID,
HTAPICALL htCall,
LPHDRVCALL lphdCall,
LPCWSTR lpszDestAddress
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdLine
O identificador para a linha na qual uma chamada deve ser desmarque.
dwAddressID
O endereço no hdLine no qual originar o unpark. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional. O TAPI não valida esse parâmetro quando essa função é chamada.
htCall
O identificador TAPI para a nova chamada não configurada. O provedor de serviços deve salvá-lo e usá-lo em todas as chamadas subsequentes para o procedimento LINEEVENT relatando eventos na chamada.
lphdCall
Um ponteiro para um HDRVCALL que representa o identificador do provedor de serviços para a nova chamada não indexada. O provedor de serviços deve preencher esse local com seu identificador para a chamada antes que este procedimento retorne. Esse identificador será inválido se a função resultar em um erro.
lpszDestAddress
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o endereço em que a chamada está estacionada. O endereço está no formato de endereço discável.
Valor retornado
Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS LINEERR_RESOURCEUNAVAIL.
Comentários
Essa função difere da função TAPI correspondente, pois segue o modelo TSPI para iniciar o tempo de vida de uma chamada. O TAPI e o provedor de serviços trocam identificadores opacos que representam a chamada entre si. Além disso, o provedor de serviços tem permissão para fazer retornos de chamada para a nova chamada antes de retornar desse procedimento. De qualquer forma, o provedor de serviços também deve tratar o identificador retornado como "ainda não válido" até depois que a mensagem de ASYNC_COMPLETION correspondente relatar êxito. Em outras palavras, ele não deve emitir nenhuma mensagem LINEEVENT para a nova chamada ou incluí-la em contagens de chamadas em mensagens ou status estruturas de dados para a linha.
O identificador de chamada criado por essa função é um identificador de chamada novo, distinto, mesmo que um identificador de chamada original para a chamada ainda exista (ele não foi destruído por TSPI_lineCloseCall).
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |