Função lineSecureCall (tapi.h)

Artigo
08/26/2023

A função lineSecureCall protege a chamada contra interrupções ou interferências que possam afetar o fluxo de mídia da chamada.

Sintaxe

LONG lineSecureCall(
  HCALL hCall
);

Parâmetros

hCall

Manipule para a chamada a ser protegida. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall pode ser qualquer estado.

Valor retornado

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_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Comentários

Uma chamada pode ser protegida para evitar interferências. Por exemplo, em um ambiente analógico, os tons de espera de chamada podem destruir uma sessão de fax ou modem na chamada original. A função lineSecureCall permite que uma chamada existente seja protegida. A função lineMakeCall fornece a opção de proteger a chamada desde o momento da configuração da chamada. A proteção de uma chamada permanece em vigor durante a chamada.