Funzione tapiRequestMakeCall (tapi.h)

La funzione tapiRequestMakeCall richiede la creazione di una chiamata vocale. Un'applicazione call-manager è responsabile di stabilire la chiamata per conto dell'applicazione richiedente, che viene quindi controllata dall'applicazione call-manager dell'utente.

Sintassi

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

Parametri

lpszDestAddress

Puntatore a una posizione di memoria in cui si trova l'indirizzo di destinazione con terminazione Null della richiesta di chiamata. L'indirizzo può usare il formato di indirizzo canonico . La validità dell'indirizzo specificato non viene verificata da questa operazione. La lunghezza massima dell'indirizzo è costituita dai caratteri TAPIMAXDESTADDRESSSIZE, che include il carattere di terminazione NULL .

lpszAppName

Puntatore a una posizione di memoria in cui si trova il nome dell'applicazione con terminazione Null della richiesta di chiamata. Questo puntatore può essere lasciato NULL se l'applicazione non fornisce un nome dell'applicazione. La lunghezza massima dell'indirizzo è costituita dai caratteri TAPIMAXAPPNAMESIZE, che include il carattere di terminazione NULL . Le stringhe più lunghe vengono troncate.

lpszCalledParty

Puntatore a una posizione di memoria in cui si trova il nome di entità con terminazione Null per la parte chiamata della chiamata. Questo puntatore può essere lasciato NULL se l'applicazione non desidera fornire queste informazioni. La lunghezza massima della stringa è COSTITUITA da caratteri TAPIMAXCALLEDPARTYSIZE, che include il carattere di terminazione NULL . Le stringhe più lunghe vengono troncate.

lpszComment

Puntatore a una posizione di memoria in cui si trova il commento con terminazione Null sulla chiamata. Questo puntatore può essere lasciato NULL se l'applicazione non fornisce un commento. La lunghezza massima dell'indirizzo è costituita da caratteri TAPIMAXCOMMENTSIZE, che include il carattere di terminazione NULL . Le stringhe più lunghe vengono troncate.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. Il valore restituito dell'errore possibile è:

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL TAPIERR_INVALPOINTER.

Commenti

Un'applicazione abilitata per la telefonia può richiedere che una chiamata venga effettuata per suo conto richiamando tapiRequestMakeCall, fornendo solo l'indirizzo di destinazione per la chiamata. Questa richiesta viene inoltrata all'applicazione di controllo delle chiamate dell'utente, che inserisce la chiamata per conto dell'applicazione originale. Un'applicazione di controllo delle chiamate predefinita viene fornita come parte di Telefonia. Gli utenti possono sostituirlo con un'applicazione di controllo delle chiamate a scelta.

Richiamare tapiRequestMakeCall quando non è in esecuzione alcuna applicazione di controllo delle chiamate restituisce l'indicazione di errore TAPIERR_NOREQUESTRECIPIENT. Se l'applicazione del controllo delle chiamate non è in esecuzione, TAPI tenta di avviare l'applicazione di controllo delle chiamate con priorità più alta, elencata per RequestMakeCall nel Registro di sistema. Richiamare questa funzione quando la coda di richieste TAPI assistita è piena restituisce l'errore TAPIERR_REQUESTQUEUEFULL.

Requisiti

Vedi anche

Informazioni di riferimento sui servizi di telefonia assistita

Panoramica dei riferimenti a TAPI 2.2