Metodo ITAddress::Forward (tapi3if.h)

Articolo
08/26/2023

Il metodo Forward inoltra le chiamate destinate all'indirizzo in base alle istruzioni di inoltro contenute in ITForwardInformation. Se pForwardInfo è impostato su NULL, l'inoltro viene annullato.

Sintassi

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

Parametri

[in] pForwardInfo

Puntatore all'interfaccia ITForwardInformation o impostata su NULL per annullare l'inoltro.

[in] pCall

Puntatore all'interfaccia ITBasicCallControl per la chiamata di consulenza, se richiesto dall'ambiente di telefonia. Può essere NULL se non richiesto.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	L'indirizzo non supporta l'inoltro o pCall non punta a una chiamata valida.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_POINTER	Il parametro pForwardInfo o pCall non è un puntatore valido.
TAPI_E_TIMEOUT	L'operazione non è riuscita perché la DLL TAPI 3 l'ha timeout. L'intervallo di timeout è di due minuti.
LINEERR_	Vedere LineForward per i codici di errore restituiti da questa funzione TAPI 2.1.

Commenti

Le informazioni in pForwardInfo sostituiscono le istruzioni di inoltro precedenti.

Se ITAddress::p ut_DoNotDisturb viene chiamato con fDoNotDisturb impostato su VARIANT_FALSE, viene annullato tutto l'inoltro.

Un'applicazione può determinare se è necessaria una chiamata di consulenza non NULL chiamando ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) e verificando se il flag LINEADDRCAPFLAGS_FWDCONSULT, un membro di costanti LINEADDRCAPFLAGS_, è stato impostato in plCapability. Se è impostato, è necessario un valore non NULL per il parametro pCall del metodo Forward.

Il metodo Forward è, in parte, un wrapper COM per la funzione LINEForward TAPI 2.1.