ITTAPI::SetApplicationPriority method (tapi3if.h)

Artikel
03/02/2024

Metode SetApplicationPriority 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

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

Parameter

[in] pAppFilename

Pointer ke BSTR yang berisi nama aplikasi.

[in] lMediaType

Media yang terkait dengan aplikasi.

[in] fPriority

Prioritas baru untuk aplikasi. Jika nilai VARIANT_FALSE diteruskan, aplikasi dihapus dari daftar prioritas untuk media atau mode permintaan yang ditentukan (jika sudah tidak ada, tidak ada kesalahan yang dihasilkan). Jika nilai VARIANT_TRUE diteruskan, aplikasi dimasukkan sebagai aplikasi prioritas tertinggi untuk media atau mode permintaan (dan dihapus dari posisi prioritas yang lebih rendah, jika sudah ada dalam daftar).

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.

Keterangan

Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk parameter pAppFilename dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.

Prioritas yang diatur dengan SetApplicationPriority akan bertahan di seluruh reboot sistem atau memulai ulang tapisrv. Fungsi ITTAPI::RegisterCallNotifications membuka baris tanpa prioritas panggilan yang ditentukan. Secara default, aplikasi prioritas tertinggi akan menjadi aplikasi yang pertama kali disebut ITTAPI::RegisterCallNotifications.