Função lineRegisterRequestRecipient (tapi.h)

Artigo
03/02/2024

A função lineRegisterRequestRecipient registra o aplicativo de invocação como um destinatário de solicitações para o modo de solicitação especificado.

Sintaxe

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

Parâmetros

hLineApp

Identificador de uso do aplicativo para a parte de linha do TAPI.

dwRegistrationInstance

DWORD específico do aplicativo que é passado de volta como um parâmetro da mensagem LINE_REQUEST. Esta mensagem notifica o aplicativo de que uma solicitação está pendente. Esse parâmetro será ignorado se bEnable estiver definido como zero. Esse parâmetro é examinado pelo TAPI apenas para registro, não para cancelamento do registro. O valor dwRegistrationInstance usado durante o cancelamento do registro não precisa corresponder ao dwRegistrationInstance usado durante o registro para um modo de solicitação.

dwRequestMode

Tipo de solicitação para a qual o aplicativo se registra. Esse parâmetro usa uma ou mais das constantes LINEREQUESTMODE_.

bEnable

Se TRUE, o aplicativo registrará os modos de solicitação especificados; se FALSE, o aplicativo desregistre para os modos de solicitação especificados.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentários

Um aplicativo habilitado para telefonia pode solicitar que uma chamada seja feita em seu nome invocando tapiRequestMakeCall. Além disso, outros aplicativos podem solicitar que as informações sejam registradas com uma determinada chamada. As solicitações tapiRequestMakeCall são enfileiradas pelo TAPI e o aplicativo de prioridade mais alta que se registrou para lidar com a solicitação recebe uma mensagem LINE_REQUEST com uma indicação do modo da solicitação pendente. Normalmente, esse aplicativo é o aplicativo de controle de chamada do usuário.

Em seguida, o aplicativo de controle de chamada que recebe essa mensagem invoca lineGetRequest, especificando o modo de solicitação e um buffer grande o suficiente para manter a solicitação. Em seguida, o aplicativo de controle de chamada interpreta e executa a solicitação.

O aplicativo destinatário também é desregistrado automaticamente para todas as solicitações quando faz um lineShutdown.