fungsi lineSetAppPriorityW (tapi.h)

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

Sintaksis

LONG lineSetAppPriorityW(
  LPCWSTR           lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCWSTR           lpszExtensionName,
  DWORD             dwPriority
);

Parameter

lpszAppFilename

Penunjuk ke string yang berisi nama file modul yang dapat dieksekusi aplikasi, tanpa data direktori. Dalam 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 diatur. 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 ini 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 ini diabaikan.

dwPriority

Parameter yang menunjukkan prioritas baru untuk aplikasi. Jika nilai 0 diteruskan, aplikasi akan 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. Kemungkinan nilai pengembalian adalah:

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

Komentar

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 berikutnya atau lineHandoff berdasarkan jenis media.

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

Nota

Header tapi.h mendefinisikan lineSetAppPriority sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

LINEEXTENSIONID

Fungsi Layanan Garis Tambahan

Gambaran Umum Referensi TAPI 2.2

lineHandoff