Fungsi SetConvertStg (ole2.h)

Artikel
02/29/2024

Fungsi SetConvertStg mengatur bit konversi dalam objek penyimpanan untuk menunjukkan bahwa objek akan dikonversi ke kelas baru saat dibuka. Pengaturan dapat diambil dengan panggilan ke fungsi GetConvertStg .

Sintaks

HRESULT SetConvertStg(
  LPSTORAGE pStg,
  BOOL      fConvert
);

Parameter

pStg

Penunjuk IStorage ke objek penyimpanan untuk mengatur bit konversi.

fConvert

Jika TRUE, mengatur bit konversi untuk objek untuk menunjukkan objek akan dikonversi saat dibuka. Jika FALSE, menghapus bit konversi.

Nilai kembali

Lihat metode IStorage::CreateStream, IStorage::OpenStream, ISequentialStream::Read, dan ISequentialStream::Write untuk kemungkinan kesalahan penyimpanan dan akses streaming.

Keterangan

Fungsi SetConvertStg menentukan status bit konversi dalam objek yang terkandung. Ini dipanggil oleh aplikasi kontainer dan server dalam proses mengonversi objek dari satu kelas ke kelas lainnya. Ketika pengguna menentukan melalui dialog Konversi Ke (yang dihasilkan kontainer dengan panggilan ke fungsi OleUIConvert ) bahwa objek akan dikonversi, kontainer harus mengambil langkah-langkah berikut:

Bongkar objek jika saat ini dimuat.
Panggil WriteClassStg untuk menulis CLSID baru ke penyimpanan objek.
Panggil WriteFmtUserTypeStg untuk menulis nama jenis pengguna baru dan format utama yang ada ke penyimpanan.
Panggil SetConvertStg dengan parameter fConvert diatur ke TRUE untuk menunjukkan bahwa objek telah ditandai untuk konversi ke kelas baru saat berikutnya dimuat.
Tepat sebelum objek dimuat, panggil OleDoAutoConvert untuk menangani konversi objek yang diperlukan, kecuali Anda memanggil OleLoad, yang memanggilnya secara internal.

Ketika objek diinisialisasi dari objek penyimpanan dan server adalah tujuan dari operasi convert-to, server objek harus melakukan hal berikut:

Panggil fungsi GetConvertStg untuk mengambil nilai bit konversi.
Jika bit diatur, server membaca data dari objek sesuai dengan format yang terkait dengan CLSID baru.
Ketika objek diminta untuk menyimpan dirinya sendiri, objek harus memanggil fungsi WriteFmtUserTypeStg menggunakan format asli normal dan jenis pengguna objek.
Objek kemudian harus memanggil SetConvertStg dengan parameter fConvert diatur ke FALSE untuk mengatur ulang bit konversi objek.

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

Lihat juga

GetConvertStg

Bagikan melalui