Fungsi WsWriteStartAttribute (webservices.h)

Artikel
08/27/2023

Operasi ini mulai menulis atribut ke elemen saat ini. WsWriteStartElement harus dipanggil sebelum atribut dapat ditulis. Setelah atribut dimulai, nilai atribut dapat ditulis menggunakan WsWriteChars, WsWriteBytes, atau WsWriteValue. Atribut harus diselesaikan menggunakan WsWriteEndAttribute.

Sintaks

HRESULT WsWriteStartAttribute(
  [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]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

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

[in, optional] prefix

Penunjuk WS_XML_STRING ke awalan yang akan digunakan untuk atribut . 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 atribut . Panjangnya harus minimal satu karakter.

[in] ns

Penunjuk WS_XML_STRING ke namespace yang akan digunakan untuk atribut .

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 prefiks ditentukan, Writer akan menggunakan awalan tersebut dan dapat menyertakan atribut XMLNS jika diperlukan untuk mengganti prefiks yang ada dalam cakupan.

[in] singleQuote

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

Catatan Dengan WS_XML_WRITER_BINARY_ENCODING 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

Jika awalan NULL ditentukan, penulis akan memilih awalan untuk namespace.

Untuk menulis atribut "xml:lang" atau "xml:space", tentukan "xml" untuk awalan, "lang" atau "spasi" untuk localName, dan "http://www.w3.org/XML/1998/namespace" untuk namespace layanan.

Jika menulis atribut menyebabkan WS_XML_WRITER_PROPERTY_MAX_ATTRIBUTES terlampaui maka WS_E_QUOTA_EXCEEDED dikembalikan.

Jika awalan yang tidak kosong ditentukan dengan namespace kosong WS_E_INVALID_FORMAT dikembalikan. (Lihat Nilai Pengembalian Windows Web Services.)

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