fungsi lineSetAppPriority (tapi.h)

Artikel
03/08/2023

Fungsi lineSetAppPriority memungkinkan aplikasi untuk mengatur prioritasnya dalam daftar prioritas handoff untuk jenis media tertentu atau mode permintaan Telepon Terbantu, atau untuk menghapus dirinya dari daftar prioritas.

Sintaks

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

Parameter

lpszAppFilename

Penunjuk ke string yang berisi nama file modul yang dapat dieksekusi aplikasi, tanpa data direktori. Di TAPI versi 2.0 atau yang lebih baru, parameter dapat menentukan nama file dalam format nama file panjang atau 8.3.

dwMediaMode

Jenis media yang prioritas aplikasinya akan ditetapkan. Nilainya bisa satu atau beberapa konstanta LINEMEDIAMODE . Nilai nol harus digunakan untuk mengatur prioritas aplikasi untuk permintaan Telepon Terbantu.

lpExtensionID

Penunjuk ke struktur jenis LINEEXTENSIONID. Parameter diabaikan

dwRequestMode

Kondisi untuk parameter ini adalah, jika parameter dwMediaMode adalah nol, parameter ini menentukan mode permintaan Telepon Terbantu yang prioritasnya akan diatur. Pasti LINEREQUESTMODE_MAKECALL. Parameter ini diabaikan jika dwMediaMode bukan nol.

lpszExtensionName

Parameter diabaikan

dwPriority

Parameter yang menunjukkan prioritas baru untuk aplikasi. Jika nilai 0 diteruskan, aplikasi dihapus dari daftar prioritas untuk media atau mode permintaan yang ditentukan; jika belum ada, tidak ada kesalahan yang dihasilkan. Jika nilai 1 diteruskan, aplikasi dimasukkan sebagai aplikasi prioritas tertinggi untuk media atau mode permintaan; dihapus dari posisi prioritas yang lebih rendah, jika sudah ada dalam daftar. Nilai lain menghasilkan kesalahan.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.

Keterangan

Jika LINEERR_INVALMEDIAMODE dikembalikan, nilai yang ditentukan dalam dwMediaMode bukan nol dan bukan salah satu konstanta LINEMEDIAMODE_.

Fungsi ini memperbarui daftar prioritas tersimpan. Jika sistem telepon diinisialisasi, sistem ini juga menetapkan prioritas aktif saat ini untuk aplikasi yang kemudian berjalan; prioritas baru digunakan pada panggilan masuk atau lineHandoff berikutnya berdasarkan jenis media.

Prioritas yang diatur dengan lineSetAppPriority akan bertahan di seluruh mulai ulang sistem atau memulai ulang tapisrv. Fungsi lineOpen membuka baris tanpa prioritas panggilan yang ditentukan. Secara default, aplikasi prioritas tertinggi akan menjadi aplikasi yang pertama kali disebut lineOpen.