Fungsi OleRegGetUserType (ole2.h)

Artikel
08/25/2023

Mendapatkan jenis pengguna dari kelas yang ditentukan dari registri.

Pengembang aplikasi objek DLL kustom menggunakan fungsi ini untuk meniru perilaku handler default OLE.

Sintaks

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Parameter

[in] clsid

CLSID dari kelas yang jenis penggunanya akan diminta.

[in] dwFormOfType

Bentuk string yang dapat disajikan pengguna. Nilai yang mungkin diambil dari enumerasi USERCLASSTYPE.

[out] pszUserType

Penunjuk ke string yang menerima jenis pengguna.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Jenis pengguna 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 ProgID = MainUserTypeName dan CLSID = MainUserTypeName hilang dari registri.

Keterangan

Aplikasi objek dapat meminta OLE untuk mendapatkan nama jenis pengguna dari kelas tertentu dengan salah satu dari dua cara. Salah satu caranya adalah dengan memanggil OleRegGetUserType. Yang lain adalah mengembalikan OLE_S_USEREG sebagai respons terhadap panggilan oleh handler objek default ke IOleObject::GetUserType. OLE_S_USEREG menginstruksikan handler default untuk memanggil OleRegGetUserType. Karena aplikasi objek DLL tidak dapat mengembalikan OLE_S_USEREG, mereka harus memanggil OleRegGetUserType, daripada mendelegasikan pekerjaan ke handler objek.

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

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

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus