Compartilhar via


Função lineProxyMessage (tapi.h)

A função lineProxyMessage é usada por um manipulador de solicitação de proxy registrado para gerar mensagens TAPI relacionadas à sua função. Por exemplo, um manipulador de agente ACD pode usar essa função para gerar mensagens LINE_AGENTSTATUS recebidas por todos os aplicativos que têm a linha especificada aberta. O TAPI suprime a geração da mensagem no hLine especificado nos parâmetros de função.

Sintaxe

LONG lineProxyMessage(
  HLINE hLine,
  HCALL hCall,
  DWORD dwMsg,
  DWORD dwParam1,
  DWORD dwParam2,
  DWORD dwParam3
);

Parâmetros

hLine

Manipule para o dispositivo de linha aberta. Isso é convertido por TAPI no hLine correto para cada aplicativo que recebe a mensagem.

hCall

Se a mensagem estiver relacionada a uma chamada específica (que não está, no caso de LINE_AGENTSTATUS), especificará o identificador do manipulador de proxy para essa chamada; deve ser definido como NULL para mensagens não relacionadas a uma chamada específica. Isso é convertido por TAPI no hCall correto para cada aplicativo que recebe a mensagem.

dwMsg

A mensagem TAPI a ser gerada. Essa deve ser uma mensagem que tem permissão para ser gerada por manipuladores de proxy.

dwParam1

Parâmetro associado à mensagem a ser enviada.

dwParam2

Parâmetro associado à mensagem a ser enviada.

dwParam3

Parâmetro associado à mensagem a ser enviada.

Retornar valor

Retornará zero se a função for bem-sucedida ou um destes valores de erro negativos:

LINEERR_INVALLINEHANDLE, LINEERR_INVALCALLHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

LINE_AGENTSTATUS

Funções de serviço de linha suplementar

Visão geral da referência do TAPI 2.2