Função tapiRequestMakeCallA (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 do gerenciador de chamadas do usuário.

Sintaxe

LONG tapiRequestMakeCallA(
  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 nuloencerrado da solicitação de chamada está localizado. O endereço pode usar o formato de 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 TAPIMAXDESTADDRESSSIZE, que inclui o terminador NULL.

lpszAppName

Ponteiro para um local de memória em que o nome de aplicativo nuloterminado pelo usuário 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 de NULL . Cadeias de caracteres mais longas são truncadas.

lpszCalledParty

Ponteiro para um local de memória em que o nome nulo-terminado chamado de festa 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 é os 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 nuloencerrado 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 de NULL . Cadeias de caracteres mais longas são truncadas.

Valor de retorno

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.

Observações

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ção TAPI assistida estiver completa retorna o erro TAPIERR_REQUESTQUEUEFULL.

Nota

O cabeçalho tapi.h define tapiRequestMakeCall como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

Referência dos Serviços de Telefonia Assistida

visão geral de referência do TAPI 2.2