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) |