Bagikan melalui


Fungsi OleRegGetUserType (ole2.h)

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