Fungsi SHCreateStreamOnFileEx (shlwapi.h)

Artikel
08/26/2023

Membuka atau membuat file dan mengambil aliran untuk membaca atau menulis ke file tersebut.

Sintaks

LWSTDAPI SHCreateStreamOnFileEx(
  [in]           LPCWSTR pszFile,
  [in]           DWORD   grfMode,
  [in]           DWORD   dwAttributes,
  [in]           BOOL    fCreate,
  [in, optional] IStream *pstmTemplate,
  [out]          IStream **ppstm
);

Parameter

[in] pszFile

Jenis: LPCWSTR

Penunjuk ke string yang dihentikan null yang menentukan nama file.

[in] grfMode

Jenis: DWORD

Satu atau beberapa nilai STGM yang digunakan untuk menentukan mode akses file dan bagaimana objek yang mengekspos aliran dibuat dan dihapus.

[in] dwAttributes

Jenis: DWORD

Satu atau beberapa nilai bendera yang menentukan atribut file jika file baru dibuat. Untuk daftar lengkap nilai yang mungkin, lihat parameter dwFlagsAndAttributes dari fungsi CreateFile .

[in] fCreate

Jenis: BOOL

Nilai BOOL yang membantu menentukan, bersama dengan grfMode, bagaimana file yang ada harus diperlakukan saat membuat aliran. Lihat Keterangan untuk detailnya.

[in, optional] pstmTemplate

Jenis: IStream*

Dicadangkan.

[out] ppstm

Jenis: IStream**

Menerima penunjuk antarmuka IStream untuk aliran yang terkait dengan file.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi SHCreateStreamOnFileEx memperluas semantik bendera STGM dan menghasilkan efek yang sama seperti memanggil fungsi CreateFile .

Parameter grfMode dan fCreate bekerja sama untuk menentukan bagaimana fungsi harus bereaksi sehubungan dengan file yang ada.

grfMode	fCreate	File ada?	Aktivitas
STGM_CREATE	Diabaikan	Ya	File dibuat ulang.
STGM_CREATE	Diabaikan	Tidak	File dibuat.
STGM_FAILIFTHERE	FALSE	Ya	File dibuka.
STGM_FAILIFTHERE	FALSE	Tidak	Panggilan gagal.
STGM_FAILIFTHERE	TRUE	Ya	Panggilan gagal.
STGM_FAILIFTHERE	TRUE	Tidak	File dibuat.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 6.0 atau yang lebih baru)