Função lineSetCallTreatment (tapi.h)

Artigo
03/02/2024

A função lineSetCallTreatment define os sons de uma parte em uma chamada sem resposta ou em espera. Exceto para validação de parâmetro básico, é uma passagem direta do TAPI para o provedor de serviços.

Sintaxe

LONG lineSetCallTreatment(
  HCALL hCall,
  DWORD dwTreatment
);

Parâmetros

hCall

Manipule para a chamada. O aplicativo deve ter privilégio OWNER.

dwTreatment

Um dos tratamentos de chamada com suporte no endereço no qual a chamada é exibida, conforme indicado por LINEADDRESSCAPS. LINEERR_INVALPARAM será retornado se não houver suporte para o tratamento especificado.

Retornar valor

Retorna um identificador de solicitação positivo se a operação assíncrona for iniciada; caso contrário, a função retornará um destes valores de erro negativos:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Comentários

O uso da funcionalidade de tratamento de chamada deve ser limitado ao controle de equipamentos herdados. Os novos equipamentos geralmente são projetados para que, em vez de tratamentos de chamada sejam gerados por equipamentos de alternância externa, as chamadas seriam conectadas a fontes de áudio baseadas em COMPUTADOR e sinais gerados usando funções padrão, como a API de Onda multimídia.