Bagikan melalui


Fungsi WsWriteText (webservices.h)

Menulis teks yang ditentukan ke penulis XML.

Untuk menulis karakter ke nilai atribut, panggil WsWriteStartAttribute. Hanya karakter spasi putih yang dapat ditulis di akar dokumen xml kecuali WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT telah diatur ke TRUE.

Sintaks

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

Parameter

[in] writer

Penunjuk ke objek WS_XML_WRITER tempat teks ditulis. Penunjuk harus mereferensikan objek XML Writer yang valid.

[in] text

Penunjuk ke teks untuk ditulis.

Catatan Lihat WS_XML_TEXT dan kelas turunannya untuk informasi selengkapnya tentang objek teks.

 

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan 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.

Keterangan

WsWriteText hanya dapat dipanggil sekali antara WsWriteStartAttribute dan WsWriteEndAttribute kecuali jenis teks adalah salah satu dari berikut:

  • WS_XML_TEXT_TYPE_UTF8
  • WS_XML_TEXT_TYPE_UTF16
  • WS_XML_TEXT_TYPE_BASE64
Catatan Jika Tipe teks diatur ke salah satu nilai sebelumnya WsWriteText dapat dipanggil lebih dari sekali. Namun, Jenis teks harus sama untuk semua panggilan dalam atribut .
 

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