funzione lineBlindTransfer (tapi.h)

Articolo
03/08/2023

La funzione lineBlindTransfer esegue un trasferimento cieco o singolo passaggio della chiamata specificata all'indirizzo di destinazione specificato.

Sintassi

LONG lineBlindTransfer(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parametri

hCall

Gestire la chiamata da trasferire. L'applicazione deve essere un proprietario di questa chiamata. Lo stato della chiamata di hCall deve essere connesso.

lpszDestAddress

TBD

dwCountryCode

Codice paese o area geografica della destinazione. Questa operazione viene usata dall'implementazione per selezionare i protocolli di stato delle chiamate per l'indirizzo di destinazione. Se viene specificato un valore pari a 0, viene usato un protocollo di stato di chiamata predefinito definito dal provider di servizi.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Commenti

Se LINEERR_INVALADDRESS viene restituito, non si verifica alcuna composizione.

Il trasferimento cieco è diverso da un trasferimento di consulenza in che nessuna chiamata di consultazione viene resa visibile all'applicazione. Al termine del trasferimento cieco, la chiamata specificata viene in genere cancellata dalla riga dell'applicazione e passa allo stato inattivo .

L'handle di chiamata dell'applicazione rimane valido dopo il completamento del trasferimento. L'applicazione deve deallocare il relativo handle usando lineDeallocateCall quando non è più interessato alla chiamata trasferita.