fungsi TSPI_lineUnpark (tspi.h)

  • Artikel

Fungsi TSPI_lineUnpark mengambil panggilan yang diparkir di alamat yang ditentukan dan mengembalikan handel panggilan untuk itu.

Sintaks

LONG TSPIAPI TSPI_lineUnpark(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HTAPICALL     htCall,
  LPHDRVCALL    lphdCall,
  LPCWSTR       lpszDestAddress
);

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdLine

Handel ke baris tempat panggilan tidak diparkir.

dwAddressID

Alamat pada hdLine untuk memulai unpark. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi. TAPI tidak memvalidasi parameter ini ketika fungsi ini dipanggil.

htCall

TAPI menangani panggilan baru yang tidak diparked. Penyedia layanan harus menyimpan ini dan menggunakannya dalam semua panggilan berikutnya ke prosedur LINEEVENT yang melaporkan peristiwa pada panggilan.

lphdCall

Penunjuk ke HDRVCALL yang mewakili pengidentifikasi penyedia layanan untuk panggilan baru yang tidak diparkir. Penyedia layanan harus mengisi lokasi ini dengan handelnya untuk panggilan sebelum prosedur ini kembali. Handel ini tidak valid jika fungsi menghasilkan kesalahan.

lpszDestAddress

Penunjuk ke string Unicode yang dihentikan null yang berisi alamat tempat panggilan diparkir. Alamat dalam format alamat bisa-putar.

Nilai kembali

Mengembalikan dwRequestID, atau nomor kesalahan jika terjadi kesalahan. Parameter aktual lResult dari ASYNC_COMPLETION yang sesuai adalah nol jika fungsi berhasil, atau nomor kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.

Keterangan

Fungsi ini berbeda dari fungsi TAPI yang sesuai karena mengikuti model TSPI untuk memulai masa pakai panggilan. TAPI dan penyedia layanan bertukar handel buram yang mewakili panggilan satu sama lain. Selain itu, penyedia layanan diizinkan untuk melakukan panggilan balik untuk panggilan baru sebelum kembali dari prosedur ini. Bagaimanapun, penyedia layanan juga harus memperlakukan handel yang dikembalikan sebagai "belum valid" sampai setelah pesan ASYNC_COMPLETION yang cocok melaporkan keberhasilan. Dengan kata lain, tidak boleh mengeluarkan pesan LINEEVENT apa pun untuk panggilan baru atau menyertakannya dalam jumlah panggilan dalam pesan atau struktur data status untuk baris tersebut.

Handel panggilan yang dibuat oleh fungsi ini adalah handel panggilan baru yang berbeda, meskipun handel panggilan asli untuk panggilan masih ada (belum dihancurkan oleh TSPI_lineCloseCall).

Persyaratan

   
Target Platform Windows
Header tspi.h

Lihat juga

ASYNC_COMPLETION

TSPI_lineCloseCall

TSPI_linePark