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 或更高版本)

另请参阅

ISequentialStream：：Read