Fungsi CLSIDFromProgIDEx (combaseapi.h)

Memicu penginstalan otomatis jika kebijakan COMClassStore diaktifkan.

Ini dianalogikan dengan perilaku CoCreateInstance ketika tidak CLSCTX_ENABLE_CODE_DOWNLOAD atau CLSCTX_NO_CODE_DOWNLOAD ditentukan.

Sintaks

HRESULT CLSIDFromProgIDEx(
  [in]  LPCOLESTR lpszProgID,
  [out] LPCLSID   lpclsid
);

Parameter

[in] lpszProgID

Pointer ke ProgID yang CLSID-nya diminta.

[out] lpclsid

Menerima pointer ke CLSID yang diambil saat pengembalian.

Nilai kembali

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	CLSID berhasil diambil.
CO_E_CLASSSTRING	CLSID terdaftar untuk ProgID tidak valid.
REGDB_E_WRITEREGDB	Terjadi kesalahan saat menulis CLSID ke registri. Lihat Keterangan di bawah ini.

Keterangan

CLSCTX_ENABLE_CODE_DOWNLOAD memungkinkan penginstalan otomatis kelas yang hilang melalui IntelliMirror/Manajemen Aplikasi dari Direktori Aktif. Jika bendera ini tidak ditentukan, Kebijakan COMClassStore ("Unduh komponen COM yang hilang") menentukan perilaku (default: tidak ada unduhan).

Jika COMClassStore Policy mengaktifkan penginstalan otomatis, CLSCTX_NO_CODE_DOWNLOAD dapat digunakan untuk secara eksplisit melarang pengunduhan untuk aktivasi.

Jika salah satu nilai registri berikut diaktifkan (artinya diatur ke 1), pengunduhan otomatis kelas yang hilang diaktifkan:

• HKEY_CURRENT_USER\Software\Policies\Microsoft\Windows\App Management\COMClassStore
• HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\App Management \COMClassStore

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

ProgIDFromCLSID