Fungsi WsPullBytes (webservices.h)

Artikel
08/27/2023

Menyiapkan panggilan balik yang akan dipanggil untuk mendapatkan byte yang akan ditulis dalam elemen .
Dalam beberapa pengodean, ini bisa lebih efisien dengan menghilangkan salinan data.

Sintaks

HRESULT WsPullBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PULL_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] writer

Penulis tempat byte akan ditulis.

[in] callback

Panggilan balik untuk dipanggil ketika waktunya untuk menulis data biner.

[in, optional] callbackState

Status yang ditentukan pengguna untuk diteruskan ke panggilan balik.

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Menampilkan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_E_INVALID_OPERATION	Operasi tidak diperbolehkan karena status objek saat ini.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.

Keterangan

WsWriteBytes dan WsPushBytes mengharuskan buffer data diberikan kepada penulis. Dalam beberapa pola penggunaan, ini mungkin memerlukan salinan data tambahan. Untuk skenario tersebut, WsPullBytes menawarkan cara untuk meminta penulis menyediakan buffer yang harus diisi dengan data.

Jika pengodean tidak dapat memanfaatkan perilaku ini, maka WsPullBytes akan segera memanggil panggilan balik dan beroperasi seolah-olah WsWriteBytes dipanggil pada data yang dihasilkan.

Persyaratan


Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	webservices.h
Pustaka	WebServices.lib
DLL	WebServices.dll

Bagikan melalui