Metode IPipeLong::P ull (objidl.h)

Mengambil data jenis bilangan bulat panjang dari sumber pipa.

Sintaks

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

Parameter

[out] buf

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

[in] cRequest

Jumlah bilangan bulat panjang yang diminta.

[out] pcReturned

Jumlah bilangan bulat panjang 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 bilangan bulat panjang yang ditentukan dalam parameter cRequest . Proksi akan membatalkan nama data ke dalam buffer yang disediakan dan mengatur jumlah bilangan bulat panjang 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

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

IPipeLong