IPipeByte：:P ull 方法 (objidlbase.h)

  • 项目

从管道源检索字节类型的数据。

语法

HRESULT Pull(
  [out] BYTE  *buf,
  [in]  ULONG cRequest,
  [out] ULONG *pcReturned
);

参数

[out] buf

指向接收数据的内存缓冲区的指针。 缓冲区必须至少能够容纳 cRequest 中指定的字节数。

[in] cRequest

请求的字节数。

[out] pcReturned

返回的实际字节数。

返回值

此方法返回S_OK指示已成功检索数据。

注解

调用 Pull 方法时，将从管道的提供程序请求数据。 调用方必须提供至少包含 cRequest 参数中指定的字节数的缓冲区。 代理会将数据解封到提供的缓冲区中，并设置 pcReturned 中实际提供的字节数。 pcReturned 参数可以小于或等于 cRequest，但它永远不会更大。 当 pcReturned 为 0 时，表示没有更多数据。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 objidlbase.h (包括 ObjIdl.h)

另请参阅

IPipeByte