ITTAPI::Metode EnumerateAddresses (tapi3if.h)

Artikel
03/02/2024

Metode EnumerateAddresses menghitung alamat yang saat ini tersedia. Disediakan untuk aplikasi C dan C++. Aplikasi klien Automation, seperti yang ditulis dalam Visual Basic, harus menggunakan metode get_Addresses .

Sintaks

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parameter

[out] ppEnumAddress

Arahkan ke antarmuka IEnumAddress .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_POINTER	Parameter ppEnumAddress bukan penunjuk yang valid.
E_INVALIDARG	Objek TAPI belum diinisialisasi.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.

Keterangan

Aplikasi biasanya menggunakan enumerasi ini untuk memeriksa kemampuan setiap alamat dan menentukan mana yang berguna untuk tujuan saat ini.

Jika alamat yang diharapkan tidak ditemukan, ini mungkin menunjukkan bahwa penyedia layanan yang sesuai belum diinstal atau tidak berfungsi dengan benar.

TAPI memanggil metode Addref pada antarmuka IEnumAddress yang dikembalikan oleh ITTAPI::EnumerateAddresses. Aplikasi harus memanggil metode Rilis pada antarmuka IEnumAddress ke sumber daya gratis yang terkait dengannya.

Jika alamat dibuat atau dihapus selama sesi TAPI, aplikasi akan diberi tahu melalui antarmuka ITTAPIEventNotification . Jika alamat telah dibuat, seperti dengan menginstal perangkat Plug and Play, ITTAPIEventNotification::Event mengembalikan anggota TE_ADDRESSCREATEenum TAPIOBJECT_EVENT. Jika alamat dihapus, ITTAPIEventNotification::Event mengembalikan TE_ADDRESSREMOVE. Memanggil EnumerateAddresses setelah peristiwa ini akan mencerminkan alamat saat ini.