Fungsi WsReadMetadata (webservices.h)
Membaca elemen Metadata dan menambahkannya ke dokumen Metadata objek Metadata.
Status objek Metadata harus diatur ke WS_METADATA_STATE_CREATED.
Jika terjadi kesalahan, status objek Metadata diatur ulang ke WS_METADATA_STATE_FAULTED.
Sintaks
HRESULT WsReadMetadata(
[in] WS_METADATA *metadata,
[in] WS_XML_READER *reader,
[in] const WS_STRING *url,
[in, optional] WS_ERROR *error
);
Parameter
[in] metadata
Penunjuk ke objek Metadata untuk menyimpan metadata yang dibaca. Penunjuk harus mereferensikan objek WS_METADATA yang valid.
[in] reader
Penunjuk ke objek Pembaca XML yang digunakan untuk membaca metadata. Penunjuk harus mereferensikan objek WS_XML_READER yang valid dan pembaca harus diposisikan pada elemen yang berisi metadata yang diinginkan.
[in] url
Penunjuk ke objek WS_STRING yang mereferensikan URL metadata yang diambil. URL digunakan untuk melacak dokumen metadata untuk menyelesaikan tautan berbasis URL antar dokumen.
Skema URL berikut didukung:
- WS_URL_HTTP_SCHEME_TYPE
- WS_URL_HTTPS_SCHEME_TYPE
- WS_URL_NETTCP_SCHEME_TYPE
Misalnya jika URL berikut ditentukan:
http://example.com/document1#fragment
http://example.com/document2
Dua URL dasar adalah:
http://example.com/document1
http://example.com/document2
[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 |
---|---|
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
|
Operasi tidak diperbolehkan karena status objek saat ini. |
|
Kuota terlampaui. |
|
Kehabisan memori. |
|
Satu atau beberapa argumen tidak valid. |
|
Elemen tidak dikonsumsi. |
|
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas. |
Keterangan
Fungsi ini mengenali jenis metadata berikut:
- Dokumen WSDL 1.1
- WS-Policy 1.2 dokumen
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 |