IStream::Metode penerapan (objidl.h)

  • Artikel

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

Lihat juga

IStorage::Commit

IStream - Implementasi File Manggala