ITPhone::metode get_PreferredAddresses (tapi3if.h)

Artikel
03/13/2024

Metode get_PreferredAddresses mengembalikan kumpulan alamat yang lebih disukai ponsel untuk digunakan. Aplikasi tidak harus memanggil ITPhone::Open sebelum menjalankan metode ini.

Metode ini ditujukan untuk Aplikasi Visual Basic dan pembuatan skrip. Aplikasi C/C++ akan merasa lebih nyaman untuk menggunakan metode EnumerateAddresses .

Sintaks

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

Parameter

[out] pAddresses

Penunjuk ke VARIAN yang berisi ITCollection penunjuk antarmuka ITAddress .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_POINTER	Parameter pAddresses bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup untuk mengalokasikan objek koleksi.

Keterangan

Jika tidak ada alamat yang dapat digunakan pada sistem, metode ini mengembalikan koleksi kosong.

Perangkat telepon mendeklarasikan dirinya sebagai lebih disukai ke alamat atau sekumpulan alamat dengan mengembalikan ID alamat/baris menggunakan fungsi PHONEGetID TAPI 2.x dengan kelas perangkat tapi/line.

Meskipun fungsi phoneGetID memerlukan handel ke perangkat telepon terbuka, aplikasi tidak perlu memanggil metode ITPhone::Open sebelum memanggil EnumeratePreferredAddresses. Ini karena implementasi objek telepon dapat membuka telepon dan memanggil phoneGetID selama inisialisasi TAPI atau ketika objek telepon baru muncul.

TAPI memanggil metode AddRef pada antarmuka ITAddress yang dikembalikan oleh ITPhone::get_PreferredAddresses. Aplikasi harus memanggil Rilis pada antarmuka ITAddress ke sumber daya gratis yang terkait dengannya.