fungsi phoneGetIcon (tapi.h)

Artikel
08/26/2023

Fungsi phoneGetIcon memungkinkan aplikasi untuk mengambil ikon khusus perangkat telepon layanan (atau khusus penyedia) yang dapat ditampilkan kepada pengguna.

Sintaks

LONG phoneGetIcon(
  DWORD   dwDeviceID,
  LPCSTR  lpszDeviceClass,
  LPHICON lphIcon
);

Parameter

dwDeviceID

Pengidentifikasi perangkat telepon yang ikonnya diminta.

lpszDeviceClass

Penunjuk ke string yang dihentikan null yang mengidentifikasi nama kelas perangkat. Kelas perangkat ini memungkinkan aplikasi untuk memilih sub-ikon tertentu yang berlaku untuk kelas perangkat tersebut. Parameter ini bersifat opsional dan dapat dibiarkan NULL atau kosong, dalam hal ini ikon tingkat tertinggi yang terkait dengan perangkat telepon daripada perangkat aliran media tertentu akan dipilih.

lphIcon

Penunjuk ke lokasi memori tempat handel ke ikon dikembalikan.

Nilai kembali

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

PHONEERR_BADDEVICEID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_NOMEM, PHONEERR_NODEVICE.

Keterangan

Fungsi phoneGetIcon menyebabkan penyedia mengembalikan handel (di lphIcon) ke sumber daya ikon (diperoleh dari LoadIcon) yang terkait dengan telepon yang ditentukan. Handel ikon adalah untuk sumber daya yang terkait dengan penyedia; aplikasi harus menggunakan CopyIcon jika ingin mereferensikan ikon setelah penyedia dibongkar, yang tidak mungkin terjadi selama aplikasi membuka telepon.

Parameter lpszDeviceClass memungkinkan penyedia untuk mengembalikan ikon yang berbeda berdasarkan jenis layanan yang direferensikan oleh pemanggil. String yang diizinkan sama dengan phoneGetID. Misalnya, jika ponsel mendukung Comm API, meneruskan "COMM" sebagai lpszDeviceClass menyebabkan penyedia mengembalikan ikon yang terkait khusus dengan fungsi perangkat Comm penyedia layanan. Parameter "tapi/phone", "", atau NULL dapat digunakan untuk meminta ikon untuk layanan telepon.

Untuk aplikasi yang menggunakan versi TAPI yang lebih lama dari 2.0, jika penyedia tidak mengembalikan ikon (baik karena kelas perangkat yang diberikan tidak valid atau penyedia tidak mendukung ikon), TAPI menggantikan ikon perangkat telepon Telepon generik. Untuk aplikasi yang menggunakan TAPI versi 2.0 atau yang lebih baru, TAPI mengganti ikon telepon default hanya jika parameter lpszDeviceClass adalah "tapi/phone", "", atau NULL. Untuk kelas perangkat lain, jika kelas perangkat yang diberikan tidak valid atau penyedia tidak mendukung ikon untuk kelas , phoneGetIcon mengembalikan PHONEERR_INVALDEVICECLASS.