IPipeLong::P ull メソッド (objidl.h)

  • [アーティクル]

パイプ ソースから long 整数型のデータを取得します。

構文

HRESULT Pull(
  [out] LONG  *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
ヘッダー objidl.h (ObjIdl.h を含む)

関連項目

IPipeLong