IStream_Read 函数 (shlwapi.h)
从指定的流中读取字节，并返回一个值，该值指示是否已成功读取所有字节。
语法
LWSTDAPI IStream_Read(
[in] IStream *pstm,
[out] void *pv,
[in] ULONG cb
);
参数
[in] pstm
类型： IStream*
指向要从中读取的流的 IStream 接口的指针。
[out] pv
类型： VOID*
指向缓冲区的指针，用于从 pstm 接收流数据。 此缓冲区的大小必须至少为 cb 字节。
[in] cb
类型： ULONG
函数应尝试从输入流读取的数据字节数。
返回值
类型： HRESULT
如果函数成功从流中读取指定数量的字节，则返回 S_OK ，否则返回 COM 故障代码。 具体而言，如果读取尝试成功，但读取的字节数少于 cb 字节，则函数将返回 E_FAIL。
注解
此函数调用 ISequentialStream：：Read 方法将数据从指定的流读取到缓冲区中。 如果函数因任何原因而失败，则输出缓冲区的内容和读取指针在输入流中的位置是未定义的。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server、Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shlwapi.h |
| DLL | Shlwapi.dll (5.0 或更高版本) |