tapiRequestMakeCall

9/19/2008

Use esta função para solicitação de estabelecimento de chamar uma voz. Um separar chamar-aplicativo gerenciamento é responsável por estabelecer a chamar de voz on Behalf Of o aplicativo solicitante. Este chamar de voz subseqüentemente é controlado pelo chamar do usuário-aplicativo Gerenciador.

Syntax

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

Parameters

• lpszDestAddress
  Um ponteiro para uma localidade memória onde o endereço NULL-Terminated destino da solicitação de chamar está localizado. O endereço pode usar o formato canônico endereço. Validade do endereço especificado não é verificada por esta operação. O comprimento máximo do endereço é TAPIMAXDESTADDRESSSIZE caracteres, que inclui o NULL terminador.

• lpszAppName
  Este parâmetro é reservado para uso futuro; o valor desse parâmetro deve ser definido como NULL.

• lpszCalledParty
  Um ponteiro para uma localidade memória onde o chamado NULL-Terminated parte nome para o chamado parte do chamar está localizado. Esse ponteiro pode ser deixado NULL se o aplicativo deseja não fornecer este informações. O comprimento máximo do seqüência de caracteres é TAPIMAXCALLEDPARTYSIZE caracteres, que inclui o NULL terminador. Mais seqüências de caracteres são truncadas.

• lpszComment
  Este parâmetro é reservado para uso futuro; o valor desse parâmetro deve ser definido como NULL.

Return Value

Retorna zero se a solicitação for bem-sucedido ou um número negativo erro se ocorrer um erro. A seguinte tabela descreve possíveis valores de retorno de erros.

Nome	Valor	Descrição
TAPIERR_NOREQUESTRECIPIENT	L-2	Nenhum aplicativo destinatário está disponível ao identificador de solicitação.
TAPIERR_REQUESTQUEUEFULL	L-3	O aplicativo do destinatário está ativo, mas seu fila de solicitações está cheio ou há memória suficiente para expansão de fila. O aplicativo chamado deve Tente novamente mais tarde.
TAPIERR_INVALDESTADDRESS	L-4	O ponteiro para endereço de destino não é válido, é NULL, ou o seqüência de caracteres endereço de destino é muito longo.
TAPIERR_REQUESTFAILED	L-16	Não usado. Reservado para uso futuro.
TAPIERR_REQUESTCANCELLED	L-17	Não usado. Reservado para uso futuro.
TAPIERR_INVALPOINTER	L-18	Um ponteiro não faz referência um válido localidade memória. Um ou mais dos ponteiros lpszDestAddress, lpszAppName, lpszCalledParty ou lpszComment tiver sido especificado, mas são inválido.

Remarks

Uma telefonia-habilitado aplicativo pode solicitação que um chamar ser colocado em seu nome invocando tapiRequestMakeCall e fornecendo endereço de destino para a chamar. Essa solicitação é encaminhada para chamar registrado do sistema-controle aplicativo, que coloca a chamar on Behalf Of o original aplicativo. Chamar um usar como padrão-aplicativo controle é fornecido como parte do subjacente plataforma.

Chamando tapiRequestMakeCall Quando nenhum aplicativo controle chamar está disponível retorna a indicação de erro TAPIERR_NOREQUESTRECIPIENT. Chamar esta função quando a fila de solicitações Assisted TAPI estiver cheio retornará o Erro TAPIERR_REQUESTQUEUEFULL.

Requirements

Header	astdtapi.h
Library	cellcore.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

Assisted TAPI Functions