Fungsi CreateRandomAccessStreamOverStream (shcore.h)

Membuat aliran akses acak Windows Runtime di sekitar implementasi dasar IStream .

Sintaks

HRESULT CreateRandomAccessStreamOverStream(
  [in]  IStream      *stream,
  [in]  BSOS_OPTIONS options,
  [in]  REFIID       riid,
  [out] void         **ppv
);

Parameter

[in] stream

Aliran COM untuk merangkum.

[in] options

Salah satu opsi BSOS_OPTIONS yang menentukan perilaku RandomAccessStream yang merangkum aliran.

[in] riid

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_RandomAccessStream.

[out] ppv

Ketika metode ini berhasil dikembalikan, berisi penunjuk antarmuka ke RandomAccessStream yang merangkum aliran yang diminta dalam riid.

Nilai kembali

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

Keterangan

Gunakan fungsi CreateRandomAccessStreamOverStream untuk membuat RandomAccessStream yang merangkum COM IStream.

Untuk informasi tentang kelas utilitas yang membantu interoperatasi antara aliran Windows Runtime dan COM, lihat Keterangan di RandomAccessStreamOverStream.

Kami menyarankan agar Anda menggunakan makro IID_PPV_ARGS , yang ditentukan dalam Objbase.h, untuk mengemas parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang ditunjukkan oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian dalam riid yang dapat menyebabkan hasil yang tidak terduga.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	shcore.h
Pustaka	ShCore.lib
DLL	ShCore.dll

Lihat juga

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream