IStream::Metode penerapan (objidl.h)
Metode Penerapan memastikan bahwa setiap perubahan yang dilakukan pada objek stream terbuka dalam mode yang ditransaksikan tercermin dalam penyimpanan induk. Jika objek stream terbuka dalam mode langsung, IStream::Commit tidak berpengaruh selain membersihkan semua buffer memori ke objek penyimpanan tingkat berikutnya. Implementasi file majemuk COM dari aliran tidak mendukung aliran pembukaan dalam mode yang ditransaksikan.
Sintaks
HRESULT Commit(
[in] DWORD grfCommitFlags
);
Parameter
[in] grfCommitFlags
Mengontrol bagaimana perubahan untuk objek stream diterapkan. Lihat enumerasi STGC untuk definisi nilai-nilai ini.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
| Menampilkan kode | Deskripsi |
|---|---|
| S_OK | Perubahan pada objek stream berhasil diterapkan ke tingkat induk. |
| E_PENDING | Hanya Penyimpanan Asinkron: Bagian atau semua data aliran saat ini tidak tersedia. |
| STG_E_MEDIUMFULL | Operasi penerapan gagal karena kurangnya ruang pada perangkat penyimpanan. |
| STG_E_REVERTED | Objek telah divalidasi oleh operasi kembali di atasnya di pohon transaksi. |
Keterangan
Metode Penerapan memastikan bahwa perubahan pada objek stream yang dibuka dalam mode yang ditransaksikan tercermin dalam penyimpanan induk. Perubahan yang telah dilakukan pada aliran sejak dibuka atau terakhir diterapkan dicerminkan ke objek penyimpanan induk. Jika induk dibuka dalam mode bertransaksi, induk dapat kembali di lain waktu, mengembalikan perubahan ke objek aliran ini. Implementasi file majemuk tidak mendukung pembukaan aliran dalam mode yang ditransaksikan, sehingga metode ini memiliki efek yang sangat sedikit selain membersihkan buffer memori. Untuk informasi selengkapnya, lihat IStream - Implementasi File Gabungan.
Jika aliran terbuka dalam mode langsung, metode ini memastikan bahwa setiap buffer memori telah dibersihkan ke objek penyimpanan yang mendasar. Ini mirip seperti flush dalam sistem file tradisional.
Metode IStream::Commit berguna pada aliran mode langsung ketika implementasi antarmuka IStream adalah pembungkus untuk API sistem file yang mendasar. Dalam hal ini, IStream::Commit akan terhubung ke panggilan flush sistem file.
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 | objidl.h |
| Pustaka | Uuid.lib |
| DLL | Ole32.dll |