Fungsi WsGetNamespaceFromPrefix (webservices.h)

Artikel
08/27/2023

Fungsi ini mengembalikan namespace dari awalan yang terikat.

Jika nilai parameter yang diperlukan diatur ke TRUE dan Awalan tidak terikat ke namespace layanan apa pun, pengecualian WS_E_INVALID_FORMAT akan dikembalikan. (Lihat Nilai Pengembalian Windows Web Services.) Jika parameter yang diperlukanADALAH FALSE, dan Awalan tidak terikat ke namespace layanan apa pun, parameter ns akan menjadi NULL dan fungsi akan mengembalikan S_FALSE.

Sintaks

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] reader

Penunjuk ke pembaca yang awalannya harus dicari.

[in] prefix

Penunjuk ke Awalan untuk dicari.

[in] required

Nilai parameter Boolean ini menentukan apakah kesalahan harus dikembalikan atau tidak jika namespace layanan yang cocok tidak ditemukan.

ns

Referensi ke namespace yang awalannya terikat jika berhasil. Nilai yang dikembalikan hanya valid sampai penulis maju.

[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.

Keterangan

Untuk awalan "xml" akan mengembalikan namespace "http://www.w3.org/XML/1998/namespace".

Untuk awalan "xmlns" akan mengembalikan namespace "http://www.w3.org/2000/xmlns/".

Persyaratan


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