ITAddressTranslation::Metode EnumerateLocations (tapi3if.h)

Metode EnumerateLocations menghitung lokasi alamat yang saat ini tersedia. Metode ini disediakan untuk aplikasi C dan C++. Aplikasi klien Automation, seperti yang ditulis dalam Visual Basic, harus menggunakan metode get_Locations .

Sintaks

HRESULT EnumerateLocations(
  [out] IEnumLocation **ppEnumLocation
);

Parameter

[out] ppEnumLocation

Penunjuk ke objek IEnumLocation dibuat.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Makna
S_OK
Metode berhasil.
E_POINTER
Parameter ppEnumLocations bukan penunjuk yang valid.
E_OUTOFMEMORY
Memori tidak cukup ada untuk membuat objek.

Keterangan

Metode EnumerateLocations adalah pembungkus COM untuk fungsi TAPI 2.1 LineGetTranslateCaps , dan mengambil informasi lokasi dari struktur LINETRANSLATECAPS yang dikembalikan oleh fungsi tersebut.

TAPI memanggil metode AddRef pada antarmuka IEnumLocation yang dikembalikan oleh ITAddressTranslation::EnumerateLocations. Aplikasi harus memanggil Rilis pada antarmuka IEnumLocation ke sumber daya gratis yang terkait dengannya.

Persyaratan

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

Lihat juga

Objek Alamat

IEnumLocation

ITAddressTranslation