Metode IStorage::EnumElements (objidl.h)
Metode EnumElements mengambil penunjuk ke objek enumerator yang dapat digunakan untuk menghitung objek penyimpanan dan aliran yang terkandung dalam objek penyimpanan ini.
Sintaks
HRESULT EnumElements(
[in] DWORD reserved1,
[in] void *reserved2,
[in] DWORD reserved3,
[out] IEnumSTATSTG **ppenum
);
Parameter
[in] reserved1
Dicadangkan untuk digunakan di masa mendatang; harus nol.
[in] reserved2
Dicadangkan untuk digunakan di masa mendatang; harus NULL.
[in] reserved3
Dicadangkan untuk digunakan di masa mendatang; harus nol.
[out] ppenum
Arahkan ke variabel pointer IEnumSTATSTG* yang menerima penunjuk antarmuka ke objek enumerator baru.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
S_OK | Objek enumerator berhasil dikembalikan. |
E_PENDING | Hanya Penyimpanan Asinkron: Bagian atau semua data elemen saat ini tidak tersedia. |
STG_E_INSUFFICIENTMEMORY | Objek enumerator tidak dapat dibuat karena kurangnya memori. |
STG_E_INVALIDPARAMETER | Salah satu parameter tidak valid. |
STG_E_REVERTED | Objek penyimpanan telah dibatalkan oleh operasi kembali di atasnya di pohon transaksi. |
Keterangan
Objek enumerator yang dikembalikan oleh metode ini mengimplementasikan antarmuka IEnumSTATSTG , salah satu antarmuka enumerator standar yang berisi metode Next, Reset, Clone, dan Skip . IEnumSTATSTG menghitung data yang disimpan dalam array struktur STATSTG .
Objek penyimpanan harus terbuka dalam mode baca untuk memungkinkan enumerasi elemennya.
Objek enumerator diizinkan untuk menghitung elemen dalam urutan apa pun. Objek enumerator juga diizinkan untuk memperlakukan enumerasi sebagai rekam jepret atau agar enumerasi mencerminkan status objek penyimpanan saat ini.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | objidl.h |
Pustaka | Uuid.lib |
DLL | Ole32.dll |