Fungsi OleRegEnumVerbs (ole2.h)

Artikel
08/25/2023

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.

Menampilkan kode	Deskripsi
OLEOBJ_E_NOVERBS	Tidak ada kata kerja yang terdaftar untuk kelas .
REGDB_E_CLASSNOTREG	Tidak ada CLSID yang terdaftar untuk objek kelas.
REGDB_E_READREGDB	Terjadi kesalahan saat membaca registri.
OLE_E_REGDB_KEY	Kunci DataFormats/GetSet hilang dari registri.

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

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	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll
Set API	ext-ms-win-com-ole32-l1-1-3 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

IEnumOLEVERB

IOleObject::EnumVerbs

Bagikan melalui