Fungsi GetConvertStg (coml2api.h)

Fungsi GetConvertStg mengembalikan nilai bit konversi saat ini untuk objek penyimpanan yang ditentukan.

Sintaks

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

Parameter

[in] pStg

Penunjuk IStorage ke objek penyimpanan tempat bit konversi akan diambil.

Nilai kembali

IStorage::OpenStream, IStorage::OpenStorage, dan ISequentialStream::Membaca kesalahan penyimpanan dan akses aliran.

Keterangan

Fungsi GetConvertStg dipanggil oleh server objek yang mendukung konversi objek dari satu format ke format lainnya. Server harus dapat membaca objek penyimpanan menggunakan format pengidentifikasi kelas sebelumnya (CLSID) dan menulis objek menggunakan format CLSID barunya untuk mendukung konversi objek. Misalnya, spreadsheet yang dibuat oleh satu aplikasi dapat dikonversi ke format yang digunakan oleh aplikasi yang berbeda.

Bit konversi diatur oleh panggilan ke fungsi SetConvertStg . Aplikasi kontainer dapat memanggil fungsi ini atas permintaan pengguna akhir, atau program penyiapan dapat memanggilnya saat menginstal versi baru aplikasi. Pengguna akhir meminta konversi objek melalui kotak dialog Konversi Ke . Ketika objek dikonversi, CLSID baru ditetapkan secara permanen ke objek, sehingga objek kemudian dikaitkan dengan CLSID baru.

Kemudian, ketika objek diaktifkan, servernya memanggil fungsi GetConvertStg untuk mengambil nilai bit konversi dari objek penyimpanan. Jika bit diatur, CLSID objek telah diubah, dan server harus membaca format lama dan menulis format baru untuk objek penyimpanan.

Setelah mengambil nilai bit, aplikasi objek harus menghapus bit konversi dengan memanggil fungsi SetConvertStg dengan parameter fConvert-nya diatur ke FALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	coml2api.h (termasuk Ole2.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

SetConvertStg