Fungsi WsCreateReader (webservices.h)

Membuat pembaca XML dengan properti yang ditentukan.

Sintaks

HRESULT WsCreateReader(
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_READER                **reader,
  [in, optional] WS_ERROR                     *error
);

Parameter

properties

Array struktur WS_XML_READER_PROPERTY yang berisi properti opsional untuk pembaca XML.

Nilai parameter ini mungkin NULL, dalam hal ini, parameter propertyCount harus 0 (nol).

Untuk properti yang bisa digunakan tiy untuk mengonfigurasi pembaca XML, lihat enumerasi WS_XML_READER_PROPERTY_ID .

[in] propertyCount

Jumlah properti dalam array properti .

reader

Jika berhasil, pointer yang menerima alamat struktur WS_XML_READER mewakili pembaca XML baru.

Ketika Anda tidak lagi membutuhkan struktur ini, Anda harus membebaskannya dengan memanggil WsFreeReader.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Gunakan fungsi WsSetInput atau WsSetInputToBuffer untuk memilih pengodean untuk pembaca XML dan untuk menunjukkan sumber input.

Jika WS_READ_CALLBACK ditentukan dalam struktur WS_XML_READER_INPUT yang diteruskan ke fungsi WsSetInput , pembaca XML hanya membaca data tambahan saat WsFillReader dipanggil. Ini memungkinkan pemanggil untuk menentukan granularitas apa yang akan membaca data dan apakah akan membaca data tersebut secara asinkron.

Struktur WS_XML_READER dapat digunakan kembali dengan memanggil WsSetInput atau WsSetInputToBuffer lagi.

Jika ada operasi API yang beroperasi pada WS_XML_READER gagal, pembaca XML dibiarkan dalam keadaan rusak dan panggilan fungsi lebih lanjut mengembalikan WS_E_OBJECT_FAULTED. (Lihat Nilai Pengembalian Windows Web Services.) Satu-satunya fungsi yang mungkin memanggil pembaca XML jika ini terjadi adalah WsSetInput dan WsSetInputToBuffer untuk mengembalikan pembaca XML ke status yang dapat digunakan, atau WsFreeReader untuk merilis objek pembaca XML.

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