Fungsi CoGetTreatAsClass (combaseapi.h)

Artikel
08/22/2023

Mengembalikan CLSID objek yang dapat meniru objek yang ditentukan.

Sintaks

HRESULT CoGetTreatAsClass(
  [in]  REFCLSID clsidOld,
  [out] LPCLSID  pClsidNew
);

Parameter

[in] clsidOld

CLSID objek yang dapat ditiru (diperlakukan sebagai) objek dengan CLSID yang berbeda.

[out] pClsidNew

Pointer ke tempat CLSID yang dapat meniru objek clsidOld diambil. Parameter ini tidak boleh NULL. Jika tidak ada informasi emulasi untuk objek clsidOld , parameter clsidOld disediakan.

Nilai kembali

Fungsi ini dapat mengembalikan nilai berikut, serta nilai kesalahan apa pun yang dikembalikan oleh fungsi CLSIDFromString .

Menampilkan kode	Deskripsi
S_OK	CLSID baru berhasil dikembalikan.
S_FALSE	Tidak ada informasi emulasi untuk parameter clsidOld , sehingga parameter pClsidNew diatur ke clsidOld.
REGDB_E_READREGDB	Terjadi kesalahan saat membaca registri.

Keterangan

CoGetTreatAsClass mengembalikan entri TreatAs dalam registri untuk objek yang ditentukan. Entri TreatAs , jika diatur, adalah CLSID dari objek terdaftar (aplikasi) yang dapat meniru objek yang dimaksud. Entri TreatAs diatur melalui panggilan ke fungsi CoTreatAsClass . Emulasi memungkinkan aplikasi untuk membuka dan mengedit objek dengan format yang berbeda, sambil mempertahankan format asli objek. Objek CLSID asli diaktifkan dan diperlakukan sebagai objek CLSID kedua. Ketika objek disimpan, ini dapat mengakibatkan hilangnya pengeditan yang tidak didukung oleh format asli. Jika tidak ada entri TreatAs untuk objek yang ditentukan, fungsi ini mengembalikan CLSID dari objek asli (clsidOld).

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

CoTreatAsClass

Bagikan melalui