Fungsi ADsEnumerateNext (adshlp.h)
Fungsi ADsEnumerateNext menghitung jumlah elemen tertentu dari posisi kursor enumerator saat ini. Ketika operasi berhasil, fungsi mengembalikan kumpulan elemen yang dijumlahkan dalam array varian. Jumlah elemen yang dikembalikan bisa lebih kecil dari angka yang ditentukan.
Sintaks
HRESULT ADsEnumerateNext(
[in] IEnumVARIANT *pEnumVariant,
[in] ULONG cElements,
[out] VARIANT *pvar,
[out] ULONG *pcElementsFetched
);
Parameter
[in] pEnumVariant
Jenis: IEnumVARIANT*
Arahkan ke antarmuka IEnumVARIANT pada objek enumerator.
[in] cElements
Jenis: ULONG
Jumlah elemen yang diminta.
[out] pvar
Jenis: VARIAN*
Penunjuk ke array elemen yang diambil.
[out] pcElementsFetched
Jenis: ULONG*
Jumlah elemen aktual yang diambil, yang dapat lebih kecil dari jumlah elemen yang diminta.
Menampilkan nilai
Jenis: HRESULT
Metode ini mendukung nilai pengembalian standar.
Untuk informasi selengkapnya tentang nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.
Keterangan
Proses umum untuk menghitung objek dalam kontainer melibatkan hal berikut:
Pertama, buat objek enumerator pada kontainer tersebut.
Kedua, ambil penunjuk antarmuka IEnumVARIANT .
Ketiga, panggil fungsi ADsEnumerateNext untuk mengembalikan set elemen enumerasi dari objek enumerator.
Keempat, panggil fungsi ADSFreeEnumerator untuk membebaskan objek enumerator.
Untuk informasi selengkapnya dan contoh kode, lihat topik ADsBuildEnumerator .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | adshlp.h |
| Pustaka | Activeds.lib |
| DLL | Activeds.dll |