Fungsi WsWriteStartElement (webservices.h)

Artikel
03/03/2024

Menulis elemen mulai ke penulis.

Setelah memanggil fungsi ini WsWriteStartAttribute atau WsWriteXmlnsAttribute dapat dipanggil untuk menulis atribut tambahan ke elemen . Elemen tidak diterapkan kepada penulis sampai WsWriteEndElement atau beberapa fungsi lain yang menulis konten dipanggil.

Sintaks

HRESULT WsWriteStartElement(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

Penunjuk ke objek WS_XML_WRITER tempat elemen mulai ditulis. Penunjuk harus mereferensikan objek Penulis XML yang valid.

[in, optional] prefix

Penunjuk WS_XML_STRING ke awalan yang akan digunakan untuk elemen mulai. Jika nilai yang dirujuk oleh parameter ini adalah NULL , Penulis akan memilih atribut.

[in] localName

Penunjuk WS_XML_STRING ke nama lokal yang digunakan oleh elemen mulai. Panjangnya harus minimal satu karakter.

[in] ns

Penunjuk WS_XML_STRING ke namespace yang akan digunakan untuk elemen mulai.

Jika tidak ada awalan yang ditentukan, Writer dapat menggunakan awalan dalam cakupan yang terikat ke namespace yang ditentukan atau dapat menghasilkan awalan dan menyertakan atribut XMLNS. Jika awalan ditentukan, Writer akan menggunakan awalan tersebut dan dapat menyertakan atribut XMLNS jika diperlukan untuk mengambil alih awalan yang ada dalam cakupan.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Mengembalikan 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.
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.

Keterangan

Jika pengodean yang mendasar mendukung elemen kosong dan elemen tidak memiliki konten elemen kosong yang ditulis.

Jika awalan tidak kosong ditentukan dengan namespace kosong WS_E_INVALID_FORMAT dikembalikan.

Jika menulis elemen mulai menyebabkan WS_XML_WRITER_PROPERTY_MAX_DEPTH terlampaui WS_E_QUOTA_EXCEEDED dikembalikan. (Lihat Nilai Pengembalian Windows Web Services.)

Saat menggunakan WS_XML_WRITER_MTOM_ENCODING itu adalah kesalahan untuk mencoba menulis elemen dengan localName "Include" dari namespace"http://www.w3.org/2004/08/xop/include".

WsWriteStartAttribute juga dapat digunakan untuk menambahkan atribut ke elemen ketika penulis diposisikan pada elemen menggunakan WsMoveWriter atau WsSetWriterPosition.

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