Fungsi WsWriteCharsUtf8 (webservices.h)

Artikel
08/27/2023

Menulis serangkaian karakter yang dikodekan sebagai UTF-8 ke elemen atau atribut. Untuk menulis karakter ke nilai atribut, panggil WsWriteStartAttribute terlebih dahulu. Hanya karakter spasi putih yang dapat ditulis di akar dokumen xml kecuali WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT telah diatur ke TRUE.

Sintaks

HRESULT WsWriteCharsUtf8(
  [in]           WS_XML_WRITER *writer,
                 const BYTE    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

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

bytes

Penunjuk ke karakter UTF-8 yang dikodekan untuk ditulis.

[in] byteCount

Jumlah byte yang akan ditulis.

[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

WsWriteCharsUtf8 dapat dipanggil lebih dari sekali antara WsWriteStartAttribute dan WsWriteEndAttribute. Ini tidak dapat dikombinasikan dengan WsWriteChars, WsWriteBytes, WsWriteValue atau WsWriteText saat menulis 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

Bagikan melalui