Bagikan melalui


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.

Menampilkan kode Deskripsi
S_OK
Informasi status berhasil dikembalikan.
REGDB_E_CLASSNOTREG
Tidak ada CLSID yang terdaftar untuk objek kelas.
REGDB_E_READREGDB
Terjadi kesalahan saat membaca dari registri.
OLE_E_REGDB_KEY
Kunci GetMiscStatus hilang dari registri.

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

   
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

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType