CreateRandomAccessStreamOnFile 函式 (shcore.h)

建立檔案的 Windows 執行階段隨機存取數據流。

語法

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

[in] filePath

要封裝之檔案的完整路徑。

[in] accessMode

AccessMode 值，指定封裝檔案之 RandomAccessStream 的行為。

[in] riid

要透過 ppv 擷取之介面 IID 的參考，通常IID_RandomAccessStream。

[out] ppv

當這個方法成功傳回時，會包含 riid 中要求的介面指標，通常是封裝檔案的 IRandomAccessStream 。

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

使用 CreateRandomAccessStreamOnFile 函式來建立 RandomAccessStream 來封裝檔案。

我們建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。這個宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除 riid 中可能導致非預期結果的程式代碼錯誤的可能性。

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	shcore.h
程式庫	Shcore.lib
Dll	Shcore.dll