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 |