Fungsi WsPullBytes (webservices.h)
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 |
---|---|
|
Satu atau beberapa argumen tidak valid. |
|
Operasi tidak diperbolehkan karena status objek saat ini. |
|
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 |