Metode IOleObject::GetUserType (oleidl.h)

Artikel
03/04/2024

Mengambil nama tipe pengguna objek untuk ditampilkan dalam elemen antarmuka pengguna seperti menu, kotak daftar, dan kotak dialog.

Sintaks

HRESULT GetUserType(
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Parameter

[in] dwFormOfType

Bentuk nama jenis pengguna yang akan disajikan kepada pengguna. Nilai yang mungkin diperoleh dari enumerasi USERCLASSTYPE .

[out] pszUserType

Alamat variabel penunjuk LPOLESTR yang menerima penunjuk ke string jenis pengguna. Pemanggil harus membebaskan pszUserType menggunakan instansIMalloc saat ini. Jika terjadi kesalahan, implementasi harus mengatur pszUserType ke NULL.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
OLE_S_USEREG	Delegasikan ke implementasi handler default menggunakan registri untuk memberikan informasi yang diminta.

Keterangan

Kontainer memanggil IOleObject::GetUserType untuk mewakili objek yang disematkan dalam kotak daftar, menu, dan kotak dialog dengan nama normal yang dapat dikenali pengguna. Contohnya termasuk "Word Document," "Excel Chart," dan "Paintbrush Object." Informasi yang dikembalikan oleh IOleObject::GetUserType setara dengan pengidentifikasi kelas biner yang dapat dibaca pengguna yang dikembalikan oleh IOleObject::GetUserClassID.

Catatan untuk Penelepon

Implementasi handler default IOleObject::GetUserType menggunakan pengidentifikasi kelas objek (parameter pClsid yang dikembalikan oleh IOleObject::GetUserClassID) dan parameter dwFormOfType bersama-sama sebagai kunci ke dalam registri. Jika entri ditemukan yang cocok dengan kunci dengan tepat, maka jenis pengguna yang ditentukan oleh entri tersebut dikembalikan. Jika hanya bagian CLSID dari kunci yang cocok, entri bernomor terendah yang tersedia (biasanya nama lengkap) yang digunakan. Jika CLSID tidak ditemukan, atau tidak ada jenis pengguna yang terdaftar untuk kelas, jenis pengguna yang saat ini ditemukan di penyimpanan objek digunakan.

Anda tidak boleh menyimpan cache string yang dikembalikan dari IOleObject::GetUserType. Sebagai gantinya, panggil metode ini setiap kali string diperlukan. Ini menjamin hasil yang benar ketika objek yang disematkan sedang dikonversi dari satu jenis ke jenis lainnya tanpa sepengetahuan pemanggil. Memanggil metode ini murah karena handler default mengimplementasikannya menggunakan registri.

Catatan untuk Pelaksana

Anda dapat menggunakan implementasi yang disediakan oleh handler default dengan mengembalikan OLE_S_USEREG sebagai implementasi aplikasi Anda dari metode ini. Jika nama jenis pengguna adalah string kosong, pesan "Objek Tidak Diketahui" dikembalikan.

Anda dapat memanggil fungsi pembantu OLE OleRegGetUserType untuk mengembalikan jenis pengguna yang sesuai.

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	oleidl.h