Fungsi WsReadEndpointAddressExtension (webservices.h)

Membaca ekstensi WS_ENDPOINT_ADDRESS.

Sintaks

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

Parameter

[in] reader

Pembaca XML yang digunakan untuk membaca ekstensi.

Fungsi ini akan secara otomatis mengatur input pembaca seperlunya untuk membaca ekstensi.

[in] endpointAddress

Alamat titik akhir yang berisi ekstensi.

[in] extensionType

Jenis ekstensi yang akan dibaca.

[in] readOption

Apakah nilai diperlukan, dan cara mengalokasikan nilai. Lihat WS_READ_OPTION untuk informasi selengkapnya.

Parameter ini harus memiliki salah satu nilai berikut:

• WS_READ_REQUIRED_VALUE.
• WS_READ_REQUIRED_POINTER.
• WS_READ_OPTIONAL_POINTER.

[in] heap

Timbunan yang digunakan untuk menyimpan nilai yang dibaca.

value

Alamat buffer untuk menempatkan nilai yang dibaca.

Jika menggunakan WS_READ_REQUIRED_VALUE untuk parameter readOption, buffer harus berukuran jenis ekstensi yang dibaca (yang bervariasi menurut WS_ENDPOINT_ADDRESS_EXTENSION_TYPE).

Jika menggunakan WS_READ_REQUIRED_POINTER atau WS_READ_OPTIONAL_POINTER, buffer harus berukuran pointer.

[in] valueSize

Ukuran buffer yang telah dialokasikan pemanggil untuk nilai yang dibaca.

Ukuran ini harus sesuai dengan ukuran buffer yang diteruskan menggunakan parameter nilai.

[in, optional] error

Menentukan tempat informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Tipe ekstensi tidak valid. Ukuran buffer yang disediakan tidak benar. Parameter yang diperlukan adalah NULL.
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
E_OUTOFMEMORY	Kehabisan memori.
Kesalahan Lain	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Nilai yang dikembalikan valid hingga heap dibebaskan atau direset.

Jika jenis ekstensi yang diminta muncul lebih dari sekali di buffer ekstensi, maka instans pertama 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