Fungsi WsCreateWriter (webservices.h)

Artikel
03/03/2024

membuat Penulis XML dengan properti yang ditentukan.

Sintaks

HRESULT WsCreateWriter(
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_WRITER                **writer,
  [in, optional] WS_ERROR                     *error
);

Parameter

properties

Array struktur WS_XML_WRITER_PROPERTY yang berisi properti opsional untuk penulis XML.

Nilai parameter ini mungkin NULL, dalam hal ini, parameter propertyCount harus 0 (nol).

[in] propertyCount

Jumlah properti dalam array properti .

writer

Jika berhasil, pointer yang menerima alamat struktur WS_XML_WRITER mewakili penulis XML yang dibuat.

Ketika Anda tidak lagi membutuhkan struktur ini, Anda harus membebaskannya dengan memanggil WsFreeWriter.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.

Keterangan

Gunakan fungsi WsSetOutput atau WsSetOutputToBuffer untuk memilih pengodean penulis XML dan untuk menunjukkan tempat mengarahkan output.

WS_XML_WRITER dapat digunakan kembali dengan memanggil WsSetOutput atau WsSetOutputToBuffer lagi.

Lihat WS_XML_WRITER_PROPERTY_ID untuk properti yang dapat digunakan untuk mengonfigurasi penulis.

Penulis XML menyangga semua data hingga WsFlushWriter dipanggil. Ini memungkinkan pemanggil untuk menentukan granularitas apa yang akan menulis data dan apakah akan menulis data tersebut secara asinkron. Data tidak ditulis sampai WsFlushWriter dipanggil.

Jika operasi pada WS_XML_WRITER gagal, penulis dibiarkan dalam keadaan rusak dan panggilan lebih lanjut ke Writer mengembalikan WS_E_OBJECT_FAULTED. (Lihat Nilai Pengembalian Windows Web Services.) Satu-satunya fungsi yang mungkin memanggil penulis XML jika ini terjadi adalah WsSetOutput dan WsSetOutputToBuffer untuk mengembalikan penulis XML ke status yang dapat digunakan, atau WsFreeWriter untuk membebaskan penulis XML.

Persyaratan

Persyaratan	Nilai
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