Funzione lineRedirectW (tapi.h)

La funzione lineRedirect reindirizza la chiamata dell'offerta specificata all'indirizzo di destinazione specificato.

Sintassi

LONG lineRedirectW(
  HCALL   hCall,
  LPCWSTR lpszDestAddress,
  DWORD   dwCountryCode
);

Parametri

hCall

Handle per la chiamata da reindirizzare. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall deve essere offrire.

lpszDestAddress

Puntatore all'indirizzo di destinazione. Segue il formato standard del numero chiamabile.

dwCountryCode

Codice paese dell'entità a cui viene reindirizzata la chiamata. Se viene specificato un valore pari a 0, viene usato un valore predefinito dall'implementazione.

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 possibili valori restituiti sono:

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

Osservazioni

Il reindirizzamento delle chiamate consente a un'applicazione di disattivare una chiamata di offerta a un altro indirizzo senza prima rispondere alla chiamata. Il reindirizzamento delle chiamate differisce dall'inoltro delle chiamate in quanto l'inoltro delle chiamate viene eseguito dall'opzione senza il coinvolgimento dell'applicazione; il reindirizzamento può essere eseguito su base chiamata dall'applicazione, ad esempio, in base alle informazioni sull'ID chiamante. Differisce dal trasferimento delle chiamate in quanto il trasferimento di una chiamata richiede la prima risposta della chiamata.

Dopo che una chiamata è stata reindirizzata correttamente, la chiamata passa in genere a inattività.

Oltre a reindirizzare una chiamata in ingresso, un'applicazione può avere la possibilità di accettare la chiamata usando lineAccept, rifiutare la chiamata usando lineDropoppure rispondere alla chiamata usando lineAnswer. La disponibilità di queste operazioni dipende dalle funzionalità del dispositivo.

Nota

L'intestazione tapi.h definisce lineRedirect come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

LINE_REPLY

Panoramica del reindirizzamento

funzioni supplementari del servizio linea

panoramica dei riferimenti TAPI 2.2

lineAccept

lineAnswer

lineDrop