Share via

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

CreateStreamOverRandomAccessStream

RandomAccessStream