funzione TSPI_lineBlindTransfer (tspi.h)

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

Sintassi

LONG TSPIAPI TSPI_lineBlindTransfer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle del provider di servizi per la chiamata da trasferire. Lo stato della chiamata di hdCall può essere connesso.

lpszDestAddress

Puntatore a una stringa Unicode con terminazione Null che identifica dove deve essere trasferita la chiamata. L'indirizzo di destinazione usa il formato numero chiamabile standard.

dwCountryCode

Codice paese o area geografica della destinazione. L'implementazione deve usare questa opzione per selezionare i protocolli di stato delle chiamate per l'indirizzo di destinazione. Se viene specificato un valore pari a 0, il provider di servizi deve usare un valore predefinito. TAPI non convalida dwCountryCode quando questa funzione viene chiamata.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResultdell'ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE.

Commenti

Il provider di servizi non esegue alcuna composizione se restituisce LINEERR_INVALADDRESS.

Il trasferimento cieco è diverso da un trasferimento di consultazione in quanto nessuna chiamata di consultazione viene resa visibile al TAPI. In genere, dopo il completamento del trasferimento cieco, la chiamata specificata viene cancellata dalla riga in cui si trovava e passa allo stato di inattività . L'handle di chiamata del provider di servizi deve rimanere valido dopo il completamento del trasferimento. TAPI causa l'invalidazione di questo handle quando non è più interessato alla chiamata trasferita tramite TSPI_lineCloseCall.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

ASYNC_COMPLETION

LINE_CALLSTATE

TSPI_lineCloseCall