Fungsi SHCreateStreamOnFileA (shlwapi.h)

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

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

Sintaks

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.

Nilai kembali

Jenis: HRESULT

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

Keterangan

SHCreateStreamOnFileEx sepenuhnya mendukung semua mode STGM dan memungkinkan pemanggil untuk 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

Persyaratan	Nilai
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 5.0 atau yang lebih baru)