Fungsi WsReadMetadata (webservices.h)

Artikel
08/27/2023

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.

Catatan Fungsi ini akan menggunakan elemen jika elemen berisi metadata. Jika elemen tidak dikenali sebagai berisi metadata, atau jenis metadata tertentu tidak diperlukan, elemen tidak dibaca.

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.

Catatan URL HARUS sepenuhnya memenuhi syarat. URL dapat memiliki pengidentifikasi fragmen.

Skema URL berikut didukung:

WS_URL_HTTP_SCHEME_TYPE
WS_URL_HTTPS_SCHEME_TYPE
WS_URL_NETTCP_SCHEME_TYPE

Setiap URL yang ditentukan menggunakan fungsi ini harus memiliki URL dasar yang unik. URL dasar dihitung dengan menghapus pengidentifikasi fragmen apa pun dari URL yang ditentukan.

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
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_INVALID_OPERATION	Operasi tidak diperbolehkan karena status objek saat ini.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.
E_OUTOFMEMORY	Kehabisan memori.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
S_FALSE	Elemen tidak dikonsumsi.
Kesalahan Lainnya	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

Bagikan melalui