Fungsi CreateRandomAccessStreamOnFile (shcore.h)

Membuat aliran akses acak Windows Runtime untuk file.

Sintaks

HRESULT CreateRandomAccessStreamOnFile(
  [in]  PCWSTR filePath,
  [in]  DWORD  accessMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] filePath

Jalur file yang sepenuhnya memenuhi syarat untuk dirangkum.

[in] accessMode

Nilai AccessMode yang menentukan perilaku RandomAccessStream yang merangkum file.

[in] riid

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

[out] ppv

Ketika metode ini berhasil dikembalikan, berisi pointer antarmuka yang diminta dalam riid, biasanya IRandomAccessStream yang merangkum file.

Nilai kembali

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

Keterangan

Gunakan fungsi CreateRandomAccessStreamOnFile untuk membuat RandomAccessStream yang merangkum file.

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

CreateRandomAccessStreamOverStream

CreateStreamOverRandomAccessStream

RandomAccessStream