Metode IStorage::EnumElements (objidl.h)

  • Artikel

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

Lihat juga

IEnumSTATSTG

IStorage - Implementasi File Gabungan

STATSTG