Fungsi OleGetAutoConvert (ole2.h)

Menentukan apakah registri diatur untuk objek CLSID tertentu untuk dikonversi secara otomatis ke CLSID lain, dan jika demikian, mengambil CLSID baru.

Sintaks

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

Parameter

[in] clsidOld

CLSID untuk objek .

[out] pClsidNew

Pointer ke variabel untuk menerima CLSID baru, jika ada. Jika konversi otomatis untuk clsidOld tidak diatur dalam registri, clsidOld akan dikembalikan. Parameter pClsidNew tidak pernah NULL.

Nilai kembali

Fungsi ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Nilai berhasil dikembalikan melalui parameter pclsidNew .
REGDB_E_CLASSNOTREG	CLSID tidak terdaftar dengan benar di registri.
REGDB_E_READREGDB	Kesalahan membaca dari registri.
REGDB_E_KEYMISSING	Konversi otomatis tidak aktif atau tidak ada entri registri untuk parameter clsidOld .

Keterangan

OleGetAutoConvert mengembalikan entri AutoConvertTo dalam registri untuk objek yang ditentukan. Subkuntah AutoConvertTo menentukan apakah objek CLSID tertentu akan dikonversi secara otomatis ke CLSID baru. Ini biasanya digunakan untuk mengonversi file yang dibuat oleh versi aplikasi yang lebih lama ke versi saat ini. Jika tidak ada entri AutoConvertTo , fungsi ini mengembalikan nilai clsidOld.

Fungsi OleDoAutoConvert memanggil OleGetAutoConvert untuk menentukan apakah objek yang ditentukan akan dikonversi. Aplikasi kontainer yang mendukung konversi objek harus memanggil OleDoAutoConvert setiap kali memuat objek. Jika kontainer menggunakan fungsi pembantu OleLoad , kontainer tidak perlu memanggil OleDoAutoConvert secara eksplisit karena OleLoad memanggilnya secara internal.

Untuk menyiapkan konversi otomatis dari kelas tertentu, Anda dapat memanggil fungsi OleSetAutoConvert (biasanya dalam program penyiapan penginstalan aplikasi). Fungsi ini menggunakan subkuntah AutoConvertTo untuk menandai kelas objek untuk konversi otomatis ke kelas objek yang berbeda. Ini adalah subkuncar kunci CLSID.

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-0 (diperkenalkan dalam Windows 8)

Lihat juga

AutoConvertTo

OleDoAutoConvert

OleSetAutoConvert