Metode IMoniker::Enum (objidl.h)

Artikel
25/08/2023

Mengambil pointer ke enumerator untuk komponen moniker komposit.

Sintaks

HRESULT Enum(
  [in]  BOOL         fForward,
  [out] IEnumMoniker **ppenumMoniker
);

Parameter

[in] fForward

Jika TRUE, menghitung moniker dari kiri ke kanan. Jika FALSE, menghitung dari kanan ke kiri.

[out] ppenumMoniker

Penunjuk ke variabel penunjuk IEnumMoniker yang menerima penunjuk antarmuka ke objek enumerator untuk moniker. Jika berhasil, implementasi harus memanggil AddRef pada objek enumerator. Ini adalah tanggung jawab penelepon untuk memanggil Rilis. Jika terjadi kesalahan atau jika moniker tidak memiliki komponen yang dapat dijumlahkan, implementasi menetapkan *ppenumMoniker ke NULL.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY, E_UNEXPECTED, dan S_OK.

Keterangan

Metode ini harus menyediakan pointer IEnumMoniker ke enumerator yang dapat menghitung komponen moniker. Misalnya, implementasi metode IMoniker::Enum untuk moniker komposit generik membuat enumerator yang dapat menentukan moniker individu yang membentuk komposit, sementara metode IMoniker::Enum untuk moniker file membuat enumerator yang mengembalikan moniker yang mewakili masing-masing komponen di jalur.

Catatan untuk Penelepon

Panggil metode ini untuk memeriksa komponen yang membentuk moniker komposit.

Catatan untuk Pelaksana

Jika kelas moniker baru tidak memiliki struktur internal yang berbeda, implementasi metode ini cukup mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.

Catatan khusus implementasi

Implementasi	Catatan
Anti-moniker	Metode ini mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.
Moniker kelas	Metode ini mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.
Moniker file	Metode ini mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.
Moniker komposit generik	Jika berhasil, metode ini mengembalikan S_OK dan meneruskan kembali enumerator yang menghitung moniker komponen yang membentuk komposit; jika tidak, metode mengembalikan E_OUTOFMEMORY.
Moniker item	Metode ini mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.
Moniker OBJREF	Metode ini mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.
Penunjuk moniker	Metode ini mengembalikan E_NOTIMPL.
Moniker URL	Metode ini mengembalikan S_OK dan mengatur ppenumMoniker ke NULL.

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	objidl.h

Lihat juga

IEnumMoniker

IMoniker

Bagikan melalui