fungsi linePrepareAddToConference (tapi.h)

Fungsi linePrepareAddToConference menyiapkan panggilan konferensi yang ada untuk penambahan pihak lain.

Sintaks

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parameter

hConfCall

Menangani panggilan konferensi. Aplikasi harus menjadi pemilik panggilan ini. Status panggilan hConfCall harus tersambung.

lphConsultCall

Arahkan ke handel HCALL. Lokasi ini kemudian dimuat dengan handel yang mengidentifikasi panggilan konsultasi yang akan ditambahkan. Awalnya, aplikasi adalah pemilik satu-satunya panggilan ini.

lpCallParams

Arahkan ke struktur LINECALLPARAMS yang berisi parameter panggilan untuk digunakan saat membuat panggilan konsultasi. Parameter ini dapat diatur ke NULL jika tidak ada parameter penyiapan panggilan khusus yang diinginkan.

Nilai kembali

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron, atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

Keterangan

Jika LINEERR_INVALLINESTATE dikembalikan, baris saat ini tidak dalam keadaan di mana operasi ini dapat dilakukan. Daftar operasi yang valid saat ini dapat ditemukan di anggota dwLineFeatures (dari jenis LINEFEATURE) dalam struktur LINEDEVSTATUS . (Baris panggilanGetLineDevStatus memperbarui informasi di LINEDEVSTATUS.)

Handel panggilan konferensi dapat diperoleh dengan lineSetupConference atau dengan lineCompleteTransfer yang diselesaikan sebagai panggilan konferensi tiga arah. Fungsi linePrepareAddToConference biasanya menempatkan panggilan konferensi yang ada dalam status onHoldPendingConference dan membuat panggilan konsultasi yang dapat ditambahkan nanti ke panggilan konferensi yang ada dengan lineAddToConference.

Panggilan konsultasi dapat dibatalkan menggunakan lineDrop. Mungkin juga aplikasi dapat bertukar antara panggilan konsultasi dan panggilan konferensi yang diadakan dengan lineSwapHold.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

Gambaran umum konferensi

LINECALLPARAMS

LINEDEVSTATUS

LINE_REPLY

Fungsi Layanan Garis Tambahan

lineAddToConference

lineCompleteTransfer

lineDrop

lineGetLineDevStatus

lineSetupConference

lineSwapHold