Baca dalam bahasa Inggris

Bagikan melalui

Fungsi OleGetAutoConvert (ole2.h)

  • Artikel

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