ItCollection::get__NewEnum metode (tapi3if.h)

Metode get__NewEnum mendapatkan enumerator untuk koleksi.

Sintaks

HRESULT get__NewEnum(
  [out] IUnknown **ppNewEnum
);

Parameter

[out] ppNewEnum

Arahkan ke antarmuka IUnknown pada objek enumerator untuk koleksi.

Panggil metode QueryInterface pada antarmuka IUnknown yang dikembalikan untuk mendapatkan penunjuk ke antarmuka enumerasi IEnumVARIANT pada koleksi. IEnumVARIANT menyediakan sejumlah metode yang dapat Anda gunakan untuk melakukan iterasi melalui koleksi.

Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.

Keterangan

Setiap antarmuka TAPI 3 yang menyertakan metode yang mengembalikan koleksi juga menyertakan metode yang mengembalikan penunjuk ke antarmuka enumerator TAPI 3. Jika Anda memprogram di C/C++, mungkin lebih mudah untuk memanggil metode enumerator koleksi secara langsung untuk mendapatkan objek enumerator, alih-alih memanggil metode ITCollection::get__NewEnum . Misalnya, metode ITTAPI::EnumerateAddresses mengembalikan penunjuk ke antarmuka IEnumAddress . IEnumAddress menyediakan metode enumerasi untuk objek Alamat.

Jika Anda memprogram di Visual Basic, Anda tidak perlu memanggil metode ini untuk menghitung koleksi. Ini karena Anda dapat memanggil fungsionalitas metode secara implisit menggunakan For... Setiap... In... Berikutnya... Membangun.

Persyaratan

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

Lihat juga

ItCollection