função TSPI_lineBlindTransfer (tspi.h)
A função TSPI_lineBlindTransfer executa uma transferência cega ou em etapa única da chamada especificada para o endereço de destino especificado.
Sintaxe
LONG TSPIAPI TSPI_lineBlindTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdCall
O identificador do provedor de serviços para a chamada a ser transferida. O estado de chamada do hdCall pode ser conectado.
lpszDestAddress
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que identifica para onde a chamada deve ser transferida. O endereço de destino usa o formato de número discável padrão.
dwCountryCode
O código de país ou região do destino. A implementação deve usar isso para selecionar os protocolos de progresso da chamada para o endereço de destino. Se um valor de 0 for especificado, o provedor de serviços deverá usar um padrão. TAPI não valida dwCountryCode quando essa função é chamada.
Retornar valor
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_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL LINEERR_INVALCOUNTRYCODE.
Comentários
O provedor de serviços não executará nenhuma discagem se retornar LINEERR_INVALADDRESS.
A transferência cega difere de uma transferência de consulta, uma vez que nenhuma chamada de consulta se torna visível para a TAPI. Normalmente, depois que a transferência cega é concluída com êxito, a chamada especificada é limpa da linha em que estava e faz a transição para o estado ocioso . O identificador de chamada do provedor de serviços deve permanecer válido após a conclusão da transferência. O TAPI faz com que esse identificador seja invalidado quando ele não estiver mais interessado na chamada transferida usando TSPI_lineCloseCall.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |