Fungsi SHCreateStreamOnFileA (shlwapi.h)

Artikel
20/11/2024

[SHCreateStreamOnFile tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakanSHCreateStreamOnFileEx .]

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

Sintaksis

C++

LWSTDAPI SHCreateStreamOnFileA(
  [in]  LPCSTR  pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

Parameter

[in] pszFile

Jenis: LPCTSTR

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.

[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.

Komentar

SHCreateStreamOnFileEx sepenuhnya mendukung semua mode STGM dan memungkinkan pemanggil menentukan atribut file jika membuat file baru.

Catatan

Header shlwapi.h mendefinisikan SHCreateStreamOnFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Bagikan melalui