Fungsi WsCreateWriter (webservices.h)
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 |
---|---|
|
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 |