Fungsi ProgIDFromCLSID (combaseapi.h)

Artikel
08/22/2023

Mengambil ProgID untuk CLSID tertentu.

Sintaks

HRESULT ProgIDFromCLSID(
  [in]  REFCLSID clsid,
  [out] LPOLESTR *lplpszProgID
);

Parameter

[in] clsid

CLSID tempat ProgID akan diminta.

[out] lplpszProgID

Alamat variabel pointer yang menerima string ProgID. String yang mewakili clsid mencakup kurung kurawal penutup.

Nilai kembali

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	ProgID berhasil dikembalikan.
REGDB_E_CLASSNOTREG	Kelas tidak terdaftar dalam registri.
REGDB_E_READREGDB	Terjadi kesalahan saat membaca dari registri.

Keterangan

Setiap kelas objek OLE yang tercantum dalam kotak dialog Sisipkan Objek harus memiliki pengidentifikasi terprogram (ProgID), string yang secara unik mengidentifikasi kelas tertentu, yang disimpan dalam registri. Selain menentukan kelayakan untuk kotak dialog Sisipkan Objek , ProgID dapat digunakan sebagai pengidentifikasi dalam bahasa pemrograman makro untuk mengidentifikasi kelas. Akhirnya, ProgID juga merupakan nama kelas yang digunakan untuk objek kelas OLE yang ditempatkan dalam kontainer OLE 1.

ProgIDFromCLSID menggunakan entri dalam registri untuk melakukan konversi. Penulis aplikasi OLE bertanggung jawab untuk memastikan bahwa registri dikonfigurasi dengan benar dalam program penyiapan aplikasi.

String ProgID harus berbeda dari nama kelas aplikasi OLE 1 apa pun, termasuk versi OLE 1 dari aplikasi yang sama, jika ada. Selain itu, string ProgID tidak boleh berisi lebih dari 39 karakter, dimulai dengan digit, atau, kecuali untuk satu titik, berisi tanda baca apa pun (termasuk garis bawah).

ProgID tidak boleh ditampilkan kepada pengguna di antarmuka pengguna. Jika Anda memerlukan string pendek yang dapat ditampilkan untuk objek, panggil IOleObject::GetUserType.

Panggil fungsi CLSIDFromProgID untuk menemukan CLSID yang terkait dengan ProgID tertentu. Pastikan untuk membebaskan ProgID yang dikembalikan ketika Anda selesai dengan memanggil fungsi CoTaskMemFree .

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	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

CLSIDFromProgID

Bagikan melalui