fungsi lineAgentSpecific (tapi.h)

Artikel
03/13/2024

Fungsi lineAgentSpecific memungkinkan aplikasi untuk mengakses fungsi khusus handler eksklusif dari handler agen yang terkait dengan alamat. Arti ekstensi khusus untuk handler agen. Setiap set ekstensi terkait agen diidentifikasi oleh ID ekstensi 128-bit yang unik secara universal yang harus diperoleh, bersama dengan spesifikasi untuk ekstensi, dari promulgator ekstensi tersebut (biasanya penulis perangkat lunak handler agen di server telefoni). Daftar ekstensi yang didukung oleh handler agen diperoleh dari struktur LINEAGENTCAPS yang dikembalikan oleh lineGetAgentCaps.

Sintaks

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hLine

Tangani ke perangkat baris terbuka.

dwAddressID

Alamat pada perangkat baris terbuka. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

dwAgentExtensionIDIndex

Posisi dalam struktur ExtensionIDList di LINEAGENTCAPS dari ekstensi handler agen yang dipanggil.

lpParams

Penunjuk ke area memori yang digunakan untuk menahan blok parameter. Format blok parameter ini khusus perangkat dan kontennya diteruskan oleh TAPI ke dan dari aplikasi handler agen di server telepon. Blok parameter ini harus menentukan fungsi yang akan dipanggil dan menyertakan ruang yang cukup untuk data apa pun yang akan dikembalikan.

dwSize

Ukuran area blok parameter, dalam byte.

Catatan Jika lpParams adalah penunjuk ke string, ukuran harus menyertakan terminator NULL .

Mengembalikan nilai

Mengembalikan pengidentifikasi permintaan positif jika operasi asinkron dimulai; jika tidak, fungsi ini mengembalikan salah satu nilai kesalahan negatif ini:

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Nilai pengembalian tambahan khusus untuk handler agen.

Keterangan

Operasi ini adalah bagian dari layanan Extended Telephony. Ini menyediakan akses ke fitur khusus handler agen tanpa menentukan maknanya.

Fungsi ini menyediakan profil parameter generik. Interpretasi struktur parameter spesifik handler. Indikasi dan balasan yang dikirim kembali ke aplikasi yang spesifik handler harus menggunakan pesan LINE_AGENTSPECIFIC .

Handler agen dapat menyediakan akses ke fungsi khusus handler dengan menentukan parameter untuk digunakan dengan fungsi ini. Aplikasi yang ingin menggunakan ekstensi ini harus berkonsultasi dengan dokumentasi khusus vendor yang menjelaskan ekstensi apa yang ditentukan. Biasanya, aplikasi yang bergantung pada ekstensi ini tidak dapat bekerja dengan lingkungan handler agen lain.