IPipeLong：:P ull 方法 (objidl.h)

  • 项目

从管道源检索长整数类型的数据。

语法

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

parameters

[out] buf

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

[in] cRequest

请求的长整数数。

[out] pcReturned

返回的实际长整数数。

返回值

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

注解

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

要求

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

请参阅

IPipeLong