IStorage::Metode OpenStream (objidl.h)
Metode OpenStream membuka objek aliran yang ada dalam objek penyimpanan ini dalam mode akses yang ditentukan.
Sintaks
HRESULT OpenStream(
[in] const OLECHAR *pwcsName,
[in] void *reserved1,
[in] DWORD grfMode,
[in] DWORD reserved2,
[out] IStream **ppstm
);
Parameter
[in] pwcsName
Penunjuk ke string Unicode karakter lebar yang dihentikan null yang berisi nama aliran yang akan dibuka. Karakter 000 hingga 01f, berfungsi sebagai karakter pertama dari nama aliran/penyimpanan, dicadangkan untuk digunakan oleh OLE. Ini adalah pembatasan file gabungan, bukan pembatasan penyimpanan terstruktur.
[in] reserved1
Dicadangkan untuk digunakan di masa mendatang; harus NULL.
[in] grfMode
Menentukan mode akses yang akan ditetapkan ke aliran terbuka. Untuk informasi selengkapnya dan deskripsi nilai yang mungkin, lihat Konstanta STGM. Mode lain yang Anda pilih setidaknya harus menentukan STGM_SHARE_EXCLUSIVE saat memanggil metode ini dalam implementasi file campuran.
[in] reserved2
Dicadangkan untuk digunakan di masa mendatang; harus nol.
[out] ppstm
Penunjuk ke variabel penunjuk IStream yang menerima penunjuk antarmuka ke objek stream yang baru dibuka. Jika terjadi kesalahan, *ppstm harus diatur ke NULL.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
S_OK | Aliran berhasil dibuka. |
E_PENDING | Hanya Penyimpanan Asinkron: Bagian atau semua data aliran saat ini tidak tersedia. |
STG_E_ACCESSDENIED | Tidak cukup izin untuk membuka aliran. |
STG_E_FILENOTFOUND | Aliran dengan nama yang ditentukan tidak ada. |
STG_E_INSUFFICIENTMEMORY | Aliran tidak dibuka karena kurangnya memori. |
STG_E_INVALIDFLAG | Nilai yang ditentukan untuk parameter grfMode bukan nilai konstanta STGM yang valid. |
STG_E_INVALIDFUNCTION | Kombinasi bendera yang ditentukan dalam parameter grfMode tidak didukung; misalnya, ketika metode ini dipanggil tanpa bendera STGM_SHARE_EXCLUSIVE. |
STG_E_INVALIDNAME | Nilai tidak valid untuk pwcsName. |
STG_E_INVALIDPOINTER | Penunjuk yang ditentukan untuk objek stream tidak valid. |
STG_E_INVALIDPARAMETER | Salah satu parameter tidak valid. |
STG_E_REVERTED | Objek penyimpanan telah dibatalkan oleh operasi kembali di atasnya di pohon transaksi. |
STG_E_TOOMANYOPENFILES | Aliran tidak dibuka karena terlalu banyak file yang terbuka. |
Keterangan
IStorage::OpenStream membuka objek aliran yang ada dalam objek penyimpanan ini dalam mode akses yang ditentukan dalam grfMode. Ada batasan pada izin yang dapat diberikan di grfMode. Misalnya, izin pada objek penyimpanan ini membatasi izin pada alirannya. Secara umum, pembatasan akses pada aliran harus lebih ketat daripada yang ada di penyimpanan induk mereka. Aliran file campuran harus dibuka dengan STGM_SHARE_EXCLUSIVE.
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk