Fungsi WsWriteXmlnsAttribute (webservices.h)

Artikel
08/27/2023

Menulis atribut Xmlns ke elemen saat ini. WsWriteStartElement harus dipanggil sebelum atribut dapat ditulis dan jika jumlah atribut melebihi jumlah maksimum atribut yang diizinkan untuk penulis, fungsi mengembalikan WS_E_QUOTA_EXCEEDED. (Lihat Nilai Pengembalian Windows Web Services.)

Sintaks

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

Penunjuk ke objek WS_XML_WRITER tempat atribut Xmlns ditulis. Penunjuk harus mereferensikan objek XML Writer 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.

Menentukan awalan yang akan digunakan untuk atribut xmlns.

[in] ns

Penunjuk WS_XML_STRING ke namespace untuk mengikat awalan.

[in] singleQuote

Menentukan apakah akan menggunakan tanda kutip tunggal atau ganda untuk nilai atribut.

Catatan Jika WS_XML_WRITER_BINARY_ENCODING diatur, karakter kutipan tidak dipertahankan dan parameter ini tidak berpengaruh.

[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

Ketentuan berikut berlaku:

Jika awalan kosong ditentukan, maka namespace default ditetapkan.
Jika awalan NULL ditentukan, Maka Writer memilih awalan yang sesuai untuk namespace.
Jika atribut Xmlns berlebihan, atribut tersebut tidak dapat ditulis.
Jika awalan yang tidak kosong ditentukan dengan namespace kosong WS_E_INVALID_FORMAT dikembalikan.

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