Metode IOpcFactory::CreateStreamOnFile (msopc.h)

Artikel
11/11/2023

Membuat aliran melalui file. Metode ini adalah pembungkus yang disederhanakan untuk panggilan ke fungsi CreateFile . Parameter CreateFile yang tidak diekspos melalui metode ini menggunakan nilai defaultnya. Untuk informasi selengkapnya, lihat CreateFile.

Sintaks

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Parameter

[in] filename

Nama file tempat aliran dibuat.

[in] ioMode

Nilai yang menjelaskan status baca/tulis aliran yang akan dibuat.

[in] securityAttributes

Untuk informasi tentang struktur SECURITY_ATTRIBUTES dalam parameter ini, lihat fungsi CreateFile .

[in] dwFlagsAndAttributes

Pengaturan dan atribut file. Untuk sebagian besar file, FILE_ATTRIBUTE_NORMAL dapat digunakan.

Untuk informasi selengkapnya tentang parameter ini, lihat CreateFile.

[out, retval] stream

Penunjuk ke antarmuka IStream aliran.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Nilai yang diteruskan dalam parameter ioMode bukan nilai enumerasi OPC_STREAM_IO_MODE yang valid.
E_POINTER	Setidaknya salah satu parameter nama file dan aliran adalah NULL.
Kesalahan fungsi CreateFile	Kode kesalahan HRESULT dari fungsi CreateFile .

Keterangan

Jangan gunakan aliran untuk menserialisasikan data paket saat aliran yang sama digunakan untuk mendeserialisasi paket, karena upaya tersebut dapat mengakibatkan perilaku yang tidak terdefinisi.

Untuk informasi tentang menggunakan metode ini saat memuat atau menyimpan paket, lihat tugas Memuat Paket atau Menyimpan Paket .

Dukungan pada Versi Windows Sebelumnya

Perilaku dan performa metode ini sama pada semua versi Windows yang didukung. Untuk informasi selengkapnya, lihat Mulai menggunakan API Pengemasan, dan Pembaruan Platform untuk Windows Vista.

Keamanan Thread

Objek pengemasan tidak aman untuk utas.

Untuk informasi selengkapnya, lihat Memulai PACKAGING API.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h