Fungsi WsGetMetadataEndpoints (webservices.h)

Artikel
03/13/2024

Mengembalikan "Titik Akhir" yang ditentukan dalam dokumen objek metadata. Memanggil fungsi ini dengan WS_METADATA_STATEdiatur ke WS_METADATA_STATE_CREATED akan menyebabkan objek metadata menyelesaikan semua referensi dalam dokumen metadata. Validasi dokumen tambahan juga akan dilakukan. Jika proses ini berhasil, objek metadata akan diatur ke WS_METADATA_STATE_RESOLVED dan penambahan dokumen berikutnya ke objek metadata tidak diizinkan. Jika ada kesalahan, objek metadata akan diatur ke WS_METADATA_STATE_FAULTED.

Catatan Data yang dikembalikan oleh fungsi ini valid hingga objek metadata dirilis atau direset. Data yang dikembalikan dari fungsi ini tidak boleh dimodifikasi.

Sintaks

HRESULT WsGetMetadataEndpoints(
  [in]           WS_METADATA           *metadata,
  [out]          WS_METADATA_ENDPOINTS *endpoints,
  [in, optional] WS_ERROR              *error
);

Parameter

[in] metadata

Penunjuk ke objek Metadata yang berisi Titik Akhir yang diinginkan. Parameter ini harus merupakan objek WS_METADATA yang valid.

[out] endpoints

Pada keberhasilan, parameter pointer ini diisi dengan informasi tentang titik akhir yang ditentukan dalam objek metadata.

[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
E_INVALIDARG	Id properti tidak didukung untuk objek ini atau buffer yang ditentukan tidak cukup besar untuk nilai.
E_OUTOFMEMORY	Sumber daya memori tidak cukup.
Kesalahan Lain	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Properti ini dapat digunakan dalam status WS_METADATA_STATE_CREATED atau WS_METADATA_STATE_RESOLVED .

Fungsi ini akan gagal jika ada dokumen metadata yang hilang. Gunakan WsGetMissingMetadataDocumentAddress untuk menentukan alamat dokumen yang hilang.

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