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 |