Metode IPipeByte::P ull (objidl.h)

Mengambil data jenis byte dari sumber pipa.

Sintaks

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

Parameter

[out] buf

Penunjuk ke buffer memori yang menerima data. Buffer harus dapat menahan setidaknya jumlah byte yang ditentukan dalam cRequest.

[in] cRequest

Jumlah byte yang diminta.

[out] pcReturned

Jumlah byte aktual yang dikembalikan.

Nilai kembali

Metode ini mengembalikan S_OK untuk menunjukkan bahwa data berhasil diambil.

Keterangan

Ketika metode Pull dipanggil, data diminta dari penyedia pipa. Pemanggil harus menyediakan buffer yang akan menyimpan setidaknya jumlah byte yang ditentukan dalam parameter cRequest . Proksi akan membatalkan nama data ke dalam buffer yang disediakan dan mengatur jumlah byte yang benar-benar disediakan dalam pcReturned. Parameter pcReturned dapat kurang dari atau sama dengan cRequest, tetapi tidak akan pernah lebih besar. Ketika pcReturned adalah 0, itu menunjukkan bahwa tidak ada lagi data.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	objidl.h (termasuk ObjIdl.h)

Lihat juga

IPipeByte