Fungsi WsWriteAttribute (webservices.h)

Artikel
08/27/2023

Tulis nilai yang ditik sebagai atribut XML.

Sintaks

HRESULT WsWriteAttribute(
  [in]           WS_XML_WRITER                  *writer,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_WRITE_OPTION                writeOption,
                 const void                     *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

Parameter

[in] writer

Penulis untuk menulis atribut.

[in] attributeDescription

Penunjuk ke deskripsi cara membuat serialisasi atribut.

[in] writeOption

Informasi tentang bagaimana nilai dialokasikan. Lihat WS_WRITE_OPTION untuk informasi selengkapnya.

value

Penunjuk ke nilai untuk diserialisasikan.

[in] valueSize

Ukuran nilai yang diserialisasikan, dalam byte.

Jika nilainya ADALAH NULL, maka ukurannya harus 0.

[in, optional] error

Menentukan tempat informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

API ini menulis atribut mulai, nilai atribut, dan atribut akhir.

Jika API gagal, status penulis input menjadi tidak terdefinisi. Satu-satunya API yang dapat digunakan pada penulis jika ini terjadi adalah WsSetOutput dan WsSetOutputToBuffer untuk mengembalikan penulis ke keadaan yang dapat digunakan, atau WsFreeWriter untuk membebaskan penulis.

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