CreateRandomAccessStreamOverStream 函式 (shcore.h)
在 IStream 基底實作周圍建立 Windows 執行階段 隨機存取數據流。
語法
HRESULT CreateRandomAccessStreamOverStream(
[in] IStream *stream,
[in] BSOS_OPTIONS options,
[in] REFIID riid,
[out] void **ppv
);
參數
[in] stream
要封裝的 COM 數據流。
[in] options
其中一個BSOS_OPTIONS選項,指定封裝數據流的 RandomAccessStream 行為。
[in] riid
要透過 ppv 擷取之介面 IID 的參考,通常IID_RandomAccessStream。
[out] ppv
當這個方法成功傳回時,會包含 RandomAccessStream 的介面指標,該介面指標會封裝 riid 中要求的數據流。
傳回值
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
使用 CreateRandomAccessStreamOverStream 函式來建立 RandomAccessStream 來封裝 COM IStream。
如需有助於 Windows 執行階段 與 COM 數據流之間互操作之公用程式類別的資訊,請參閱 RandomAccessStreamOverStream 的。
我們建議您使用 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 |
另請參閱
CreateRandomAccessStreamOnFile