Fungsi OleRegEnumVerbs (ole2.h)

Menyediakan enumerasi kata kerja terdaftar untuk kelas yang ditentukan. Pengembang aplikasi objek DLL kustom menggunakan fungsi ini untuk meniru perilaku handler objek default.

Sintaks

HRESULT OleRegEnumVerbs(
  [in]  REFCLSID      clsid,
  [out] LPENUMOLEVERB *ppenum
);

Parameter

[in] clsid

Pengidentifikasi kelas yang kata kerjanya diminta.

[out] ppenum

Alamat variabel pointer IEnumOLEVERB* yang menerima penunjuk antarmuka ke objek enumerasi baru.

Nilai kembali

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

Keterangan

Aplikasi objek dapat meminta OLE untuk membuat objek enumerasi untuk struktur OLEVERB untuk menghitung kata kerja yang didukung dengan salah satu dari dua cara. Salah satu caranya adalah dengan memanggil OleRegEnumVerbs. Cara lain adalah mengembalikan OLE_S_USEREG sebagai respons terhadap panggilan oleh handler objek default ke IOleObject::EnumVerbs. OLE_S_USEREG menginstruksikan handler default untuk memanggil OleRegEnumVerbs. Karena aplikasi objek DLL tidak dapat mengembalikan OLE_S_USEREG, aplikasi harus memanggil OleRegEnumVerbs daripada mendelegasikan pekerjaan ke handler objek. Dengan penunjuk IEnumOLEVERB yang disediakan ke objek , Anda dapat memanggil metode objek enumerasi standar untuk melakukan enumerasi.

Fungsi OleRegEnumVerbs dan fungsi saudaranya, OleRegGetUserType, OleRegGetMiscStatus, dan OleRegEnumFormatEtc, menyediakan cara bagi pengembang aplikasi objek DLL kustom untuk meniru perilaku handler objek default OLE dalam mendapatkan informasi tentang objek dari registri. Dengan menggunakan fungsi-fungsi ini, Anda menghindari pekerjaan penulisan Anda sendiri yang cukup besar, dan jebakan yang melekat dalam bekerja langsung di registri. Selain itu, Anda mendapatkan penyempurnaan dan pengoptimalan fungsi-fungsi ini di masa mendatang tanpa harus mengkodekannya sendiri.

Persyaratan

Lihat juga

IEnumOLEVERB

IOleObject::EnumVerbs