Fungsi OleRegGetMiscStatus (ole2.h)

Mengembalikan informasi lain-lain tentang presentasi dan perilaku yang didukung oleh CLSID yang ditentukan dari registri.

Fungsi ini digunakan oleh pengembang aplikasi objek DLL kustom untuk meniru perilaku handler default OLE.

Sintaks

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

Parameter

[in] clsid

CLSID dari kelas yang informasi statusnya akan diminta.

[in] dwAspect

Aspek presentasi kelas yang informasinya diminta. Nilai yang mungkin diambil dari enumerasi DVASPECT .

[out] pdwStatus

Penunjuk ke variabel yang menerima informasi status.

Menampilkan nilai

Fungsi ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY, serta nilai berikut.

Keterangan

Aplikasi objek dapat meminta OLE untuk mendapatkan informasi status lain-lain dengan salah satu dari dua cara. Salah satu caranya adalah dengan memanggil OleRegGetMiscStatus. Yang lain adalah mengembalikan OLE_S_USEREG sebagai respons terhadap panggilan oleh handler objek default ke IOleObject::GetMiscStatus. OLE_S_USEREG menginstruksikan handler default untuk memanggil OleRegGetMiscStatus. Karena aplikasi objek DLL tidak dapat mengembalikan OLE_S_USEREG, mereka harus memanggil OleRegGetMiscStatus daripada mendelegasikan pekerjaan ke handler objek.

OleRegGetMiscStatus dan fungsi saudaranya, OleRegGetUserType, OleRegEnumFormatEtc, dan OleRegEnumVerbs, 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

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType