共用方式為

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

  • 發行項

從管道來源擷取位元組類型的數據。

語法

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

參數

[out] buf

接收數據的記憶體緩衝區指標。 緩衝區必須能夠保存 至少 cRequest 中指定的位元元組數目。

[in] cRequest

要求的位元元組數目。

[out] pcReturned

傳回的實際位元組數目。

傳回值

這個方法會傳回S_OK，指出已成功擷取數據。

備註

呼叫 Pull 方法時，會從管道的提供者要求數據。 呼叫端必須提供緩衝區，以保存 至少 cRequest 參數中指定的位元組數目。 Proxy 會將數據解除封存到提供的緩衝區中，並設定 實際在pcReturned中提供的位元組數目。 pcReturned 參數可以小於或等於 cRequest，但永遠不會更大。 當 pcReturned 為 0 時，表示沒有任何數據。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 objidl.h (包含 ObjIdl.h)

另請參閱

IPipeByte