Fungsi WsSetOutput (webservices.h)

Artikel
08/27/2023

Mengatur pengodean dan panggilan balik output untuk penulis. Panggilan balik digunakan untuk menyediakan buffer kepada penulis dan untuk melakukan i/o asinkron.

Sintaks

HRESULT WsSetOutput(
  [in]           WS_XML_WRITER                *writer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
  [in, optional] const WS_XML_WRITER_OUTPUT   *output,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] writer

Penulis yang outputnya akan diatur.

[in, optional] encoding

Pengodean menjelaskan format byte input. Ini harus menjadi salah satu WS_XML_WRITER_TEXT_ENCODING, WS_XML_WRITER_BINARY_ENCODING atau WS_XML_WRITER_MTOM_ENCODING.

[in, optional] output

Menentukan di mana penulis harus menempatkan datanya.

properties

Array properti opsional penulis. Lihat WS_XML_WRITER_PROPERTY.

[in] propertyCount

Jumlah properti.

[in, optional] error

Menentukan tempat informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.

Keterangan

Ketika WsSetOutput digunakan pada penulis, penulis akan berfungsi dengan cara maju saja dan fungsi WsGetWriterPosition, WsSetWriterPosition dan WsMoveWriter tidak dapat digunakan.

Jika pengodeanNULL, maka WS_XML_WRITER_OUTPUT diabaikan dan penulis disiapkan sehingga setiap upaya untuk menulis ke sana akan gagal.

Jika pengodean bukan NULL, maka WS_XML_WRITER_OUTPUT juga harus non-NULL.

Jika WS_XML_WRITER_OUTPUT WS_XML_WRITER_BUFFER_OUTPUT maka penulis akan menyangga byte dokumen yang dihasilkan. Gunakan WsGetWriterProperty dengan WS_XML_WRITER_PROPERTY_BUFFERS atau WS_XML_WRITER_PROPERTY_BYTES untuk mendapatkan byte ini. Dalam mode ini WsFlushWriter tidak berpengaruh.

Jika WS_XML_WRITER_OUTPUT WS_XML_WRITER_STREAM_OUTPUT maka penulis akan meneruskan byte dokumen yang dihasilkan ke WS_WRITE_CALLBACK yang ditentukan selama panggilan ke WsFlushWriter.

Penulis akan diinisialisasi untuk menggunakan properti yang ditentukan dalam WsCreateWriter. Properti apa pun yang ditentukan untuk WsSetOutput akan mengambil alih properti tersebut.

Lihat WsCreateWriter untuk nilai default properti penulis.

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