Metode ITAddress2::EnumeratePreferredPhones (tapi3if.h)

Metode EnumeratePreferredPhones menghitung objek telepon pilihan untuk alamat ini.

Metode ini ditujukan untuk aplikasi C/C++. Aplikasi Visual Basic dan pembuatan skrip harus menggunakan metode get_PreferredPhones .

Sintaks

HRESULT EnumeratePreferredPhones(
  [out] IEnumPhone **ppEnumPhone
);

Parameter

[out] ppEnumPhone

Penunjuk ke lokasi di mana, pada keberhasilan, metode ini akan menempatkan penunjuk ke objek enumerasi yang berisi daftar telepon yang dikembalikan.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

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

Keterangan

Perangkat telepon menyatakan dirinya lebih disukai ke alamat atau sekumpulan alamat dengan mengembalikan ID alamat/baris menggunakan phoneGetID dengan tapi/line kelas perangkat. Jika tidak ada ponsel yang tersedia untuk digunakan dengan alamat, metode ini menghasilkan enumerasi kosong dan mengembalikan S_OK.

TAPI memanggil metode AddRef pada antarmuka IEnumPhone yang dikembalikan oleh ITAddress2::EnumeratePreferredPhones. Aplikasi harus memanggil Rilis pada antarmuka IEnumPhone ke sumber daya gratis yang terkait dengannya.

Persyaratan

Target Platform	Windows
Header	tapi3if.h (termasuk Tapi3.h)
Pustaka	Uuid.lib
DLL	Tapi3.dll

Lihat juga

IEnumPhone

ITAddress2