ITAddressTranslation::get_Locations metode (tapi3if.h)

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

Sintaks

HRESULT get_Locations(
  [out] VARIANT *pVariant
);

Parameter

[out] pVariant

Pointer ke VARIAN yang berisi ITCollection penunjuk antarmuka ITLocationInfo (objek lokasi).

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_POINTER	Parameter pVariant bukan penunjuk yang valid.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.

Keterangan

Metode get_Locations 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 ITLocationInfo yang dikembalikan oleh ITAddressTranslation::get_Locations. Aplikasi harus memanggil Rilis pada antarmuka ITLocationInfo 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

Objek Alamat

EnumerateLocations

ITAddressTranslation

ItCollection

ITLocationInfo