IStorage::Metode OpenStream (objidl.h)

  • Artikel

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

IStorage - Implementasi File Gabungan

IStorage::CreateStream

IStream