função TSPI_lineCompleteCall (tspi.h)

Artigo
03/03/2024

A função TSPI_lineCompleteCall é usada para especificar como uma chamada que não pode ser conectada normalmente deve ser concluída. A rede ou a opção pode não ser capaz de concluir uma chamada porque os recursos de rede estão ocupados ou a estação remota está ocupada ou não responde.

Sintaxe

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador do provedor de serviços para a chamada cuja conclusão é solicitada. O estado de chamada do hdCall pode estar ocupado, ringback ou em andamento.

lpdwCompletionID

Um ponteiro para um local de memória do tamanho de DWORD em que o provedor de serviços grava um identificador de conclusão. Isso identifica exclusivamente uma solicitação de conclusão em andamento na linha que contém o hdCall. Em particular, um identificador de conclusão torna-se inválido após a conclusão da solicitação ou é cancelado usando a função TSPI_lineUncompleteCall . O provedor de serviços é gratuito para reutilizar o identificador de conclusão assim que ele se torna inválido.

dwCompletionMode

A maneira como a chamada deve ser concluída. Esse parâmetro usa uma e apenas uma das constantes LINECALLCOMPLMODE_.

dwMessageID

A mensagem que deve ser enviada ao concluir a chamada usando LINECALLCOMPLMODE_MESSAGE. Esse identificador seleciona a mensagem de um pequeno número de mensagens predefinidas. Esse parâmetro não é validado pelo TAPI 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 possíveis valores retornados são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLCOMPLMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_COMPLETIONOVERRUN, LINEERR_INVALMESSAGEID.

Comentários

Essa função é considerada concluída quando a solicitação é aceita pela rede ou pela opção; não quando a solicitação for totalmente concluída da maneira especificada. Quando a estação ou rede chamada entra em um estado em que a chamada pode ser concluída conforme solicitado, o provedor de serviços deve enviar uma mensagem LINE_CALLSTATE com o estado de chamada igual à oferta. O registro LINECALLINFO da chamada lista o motivo da chamada como CALLCOMPLETION e também fornece o identificador de conclusão. É possível ter várias solicitações de conclusão de chamada pendentes a qualquer momento; o número máximo depende do dispositivo. O identificador de conclusão também é usado para fazer referência a cada solicitação individual para que as solicitações possam ser canceladas chamando TSPI_lineUncompleteCall.