Funzione lineBlindTransferA (tapi.h)

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

Sintassi

LONG lineBlindTransferA(
  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. Viene usato 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 delle chiamate 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 possibili valori restituiti 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.

Osservazioni

Se viene restituito LINEERR_INVALADDRESS, non viene eseguita alcuna composizione.

Il trasferimento cieco è diverso da un trasferimento di consultazione in quanto 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 di inattività .

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.

Nota

L'intestazione tapi.h definisce lineBlindTransfer 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

funzioni supplementari del servizio linea

panoramica dei riferimenti TAPI 2.2

panoramica trasferimento

lineDeallocateCall