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 函数创建封装 COM IStream 的 RandomAccessStream。

有关有助于Windows 运行时和 COM 流之间互操作的实用工具类的信息，请参阅 RandomAccessStreamOverStream 中的“备注”。

建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏打包 riid 和 ppv 参数。 此宏根据 ppv 中的 值指向的接口提供正确的 IID，这消除了 riid 中可能导致意外结果的编码错误的可能性。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 shcore.h
Library ShCore.lib
DLL ShCore.dll

另请参阅

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream