Fungsi WsWriteType (webservices.h)

Artikel
03/03/2024

Tulis nilai WS_TYPE tertentu ke XML sesuai dengan WS_TYPE_MAPPING.

Sintaks

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] writer

Penulis untuk menulis nilai.

[in] typeMapping

Menjelaskan bagaimana jenis memetakan ke XML yang sedang ditulis.

[in] type

Jenis nilai yang akan diserialisasikan.

[in, optional] typeDescription

Informasi tambahan tentang jenis tersebut. Setiap jenis memiliki struktur deskripsi yang berbeda. Ini mungkin NULL, tergantung pada WS_TYPE.

[in] writeOption

Apakah nilai diperlukan, dan bagaimana nilai dialokasikan. Lihat WS_WRITE_OPTION untuk informasi selengkapnya.

Parameter ini harus memiliki salah satu nilai berikut:

value

Penunjuk ke nilai untuk diserialisasikan.

[in] valueSize

Ukuran nilai yang diserialisasikan.

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

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.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Lihat WS_TYPE_MAPPING cara menggunakan fungsi ini untuk menulis nilai dalam elemen dan atribut.

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

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