ITAddress::Metode penerusan (tapi3if.h)

Artikel
08/26/2023

Metode Penerusan meneruskan panggilan yang ditujukan untuk alamat sesuai dengan instruksi penerusan yang terkandung dalam ITForwardInformation. Jika pForwardInfo diatur ke NULL, penerusan dibatalkan.

Sintaks

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

Parameter

[in] pForwardInfo

Arahkan ke antarmuka ITForwardInformation , atau atur ke NULL untuk membatalkan penerusan.

[in] pCall

Arahkan ke antarmuka ITBasicCallControl untuk panggilan konsultasi, jika diperlukan oleh lingkungan telepon. Mungkin NULL jika tidak diperlukan.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Alamat tidak mendukung penerusan, atau pCall tidak menunjuk ke panggilan yang valid.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.
E_POINTER	Parameter pForwardInfo atau pCall bukan penunjuk yang valid.
TAPI_E_TIMEOUT	Operasi gagal karena DLL TAPI 3 kehabisan waktu. Interval batas waktu adalah dua menit.
LINEERR_	Lihat LineForward untuk kode kesalahan yang dikembalikan dari fungsi TAPI 2.1 ini.

Keterangan

Informasi di pForwardInfo mengambil alih instruksi penerusan sebelumnya.

Jika ITAddress::p ut_DoNotDisturb dipanggil dengan fDoNotDisturb diatur ke VARIANT_FALSE, semua penerusan dibatalkan.

Aplikasi dapat menentukan apakah panggilan konsultasi non-NULL diperlukan dengan memanggil ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) dan memeriksa apakah bendera LINEADDRCAPFLAGS_FWDCONSULT, anggota LINEADDRCAPFLAGS_ Constants, telah diatur dalam plCapability. Jika diatur, nilai non-NULL diperlukan untuk parameter pCall dari metode Teruskan.

Metode Teruskan adalah, sebagian, pembungkus COM untuk fungsi TAPI 2.1 LineForward .