Função lineCompleteCall (tapi.h)

Artigo
08/26/2023

A função lineCompleteCall especifica como uma chamada que não pôde 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. O aplicativo pode solicitar que a chamada seja concluída de várias maneiras.

Sintaxe

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

Parâmetros

hCall

Manipule para a chamada cuja conclusão é solicitada. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall deve estar ocupado ou em toque.

lpdwCompletionID

Ponteiro para um local de memória do tamanho DWORD. O identificador de conclusão é usado para identificar solicitações de conclusão individuais em andamento. Um identificador de conclusão se torna inválido e pode ser reutilizado após a conclusão da solicitação ou após o cancelamento de uma solicitação pendente.

dwCompletionMode

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

dwMessageID

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.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

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

Comentários

Essa função é considerada concluída quando a solicitação foi aceita pela rede ou pela opção; não quando a solicitação for totalmente concluída da maneira especificada. Após a conclusão dessa função, a chamada normalmente faz a transição para ociosa. Quando a estação ou rede chamada entra em um estado em que a chamada pode ser concluída conforme solicitado, o aplicativo é notificado por 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; o número máximo depende do dispositivo. O identificador de conclusão também é usado para se referir a cada solicitação individual para que as solicitações possam ser canceladas chamando lineUncompleteCall.