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