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 |