Metode IOleContainer::EnumObjects (oleidl.h)

Artikel
03/01/2024

Menghitung objek dalam kontainer saat ini.

Sintaks

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Parameter

[in] grfFlags

Menentukan objek mana dalam kontainer yang akan dijumlahkan, seperti yang didefinisikan dalam enumerasi OLECONTF.

[out] ppenum

Penunjuk ke variabel pointer IEnumUnknown yang menerima penunjuk antarmuka ke objek enumerator. Setiap kali kontainer menerima panggilan yang berhasil ke EnumObjects, kontainer harus meningkatkan jumlah referensi pada penunjuk ppenum yang dikembalikan metode. Adalah tanggung jawab penelepon untuk memanggil IUnknown::Release ketika selesai dengan pointer. Jika kesalahan dikembalikan, implementasi harus mengatur ppenum ke NULL.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.
E_NOTIMPL	Enumerasi objek tidak didukung.

Keterangan

Kontainer harus mengimplementasikan EnumObjects untuk memungkinkan klien terprogram mengetahui objek apa yang dipegangnya. Namun, metode ini tidak dipanggil dalam skenario penautan standar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h

Lihat juga

Bagikan melalui