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 |
|---|---|
|
Metode berhasil. |
|
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 |