Função tapiRequestMakeCall (tapi.h)

A função tapiRequestMakeCall solicita o estabelecimento de uma chamada de voz. Um aplicativo gerenciador de chamadas é responsável por estabelecer a chamada em nome do aplicativo solicitante, que é controlado pelo aplicativo gerenciador de chamadas do usuário.

Sintaxe

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

Parâmetros

lpszDestAddress

Ponteiro para um local de memória em que o endereço de destino encerrado em nulo da solicitação de chamada está localizado. O endereço pode usar o formato de endereço canônico . A validade do endereço especificado não é verificada por esta operação. O comprimento máximo do endereço é de caracteres TAPIMAXDESTADDRESSIZE, que inclui o terminador NULL .

lpszAppName

Ponteiro para um local de memória em que o nome de aplicativo amigável encerrado em nulo da solicitação de chamada está localizado. Esse ponteiro poderá ser deixado NULL se o aplicativo não fornecer um nome de aplicativo. O comprimento máximo do endereço é de caracteres TAPIMAXAPPNAMESIZE, que inclui o terminador NULL . Cadeias de caracteres mais longas são truncadas.

lpszCalledParty

Ponteiro para um local de memória em que o nome da parte chamada terminada em nulo para a parte chamada da chamada está localizado. Esse ponteiro poderá ser deixado NULL se o aplicativo não quiser fornecer essas informações. O comprimento máximo da cadeia de caracteres é de caracteres TAPIMAXCALLEDPARTYSIZE, que inclui o terminador NULL . Cadeias de caracteres mais longas são truncadas.

lpszComment

Ponteiro para um local de memória em que o comentário encerrado em nulo sobre a chamada está localizado. Esse ponteiro poderá ser deixado NULL se o aplicativo não fornecer um comentário. O comprimento máximo do endereço é de caracteres TAPIMAXCOMMENTSIZE, que inclui o terminador NULL . Cadeias de caracteres mais longas são truncadas.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. O valor de retorno de erro possível é:

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL, TAPIERR_INVALPOINTER.

Comentários

Um aplicativo habilitado para telefonia pode solicitar que uma chamada seja feita em seu nome invocando tapiRequestMakeCall, fornecendo apenas o endereço de destino para a chamada. Essa solicitação é encaminhada para o aplicativo de controle de chamada do usuário, que coloca a chamada em nome do aplicativo original. Um aplicativo de controle de chamada padrão é fornecido como parte da Telefonia. Os usuários podem substituí-lo por um aplicativo de controle de chamada de sua escolha.

Invocar tapiRequestMakeCall quando nenhum aplicativo de controle de chamada estiver em execução retorna a indicação de erro TAPIERR_NOREQUESTRECIPIENT. Se o aplicativo de controle de chamada não estiver em execução, o TAPI tentará iniciar o aplicativo de controle de chamada de prioridade mais alta (que está listado para RequestMakeCall no registro). Invocar essa função quando a fila de solicitações TAPI assistida estiver completa retorna o erro TAPIERR_REQUESTQUEUEFULL.

Requisitos

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

Confira também

Referência dos Serviços de Telefonia Assistida

Visão geral da referência do TAPI 2.2