Bagikan melalui


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.

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