Fungsi WsWriteQualifiedName (webservices.h)
Menulis nama xml yang memenuhi syarat ke Penulis.
Sintaks
HRESULT WsWriteQualifiedName(
[in] WS_XML_WRITER *writer,
[in, optional] const WS_XML_STRING *prefix,
[in] const WS_XML_STRING *localName,
[in, optional] const WS_XML_STRING *ns,
[in, optional] WS_ERROR *error
);
Parameter
[in] writer
Penunjuk ke objek WS_XML_WRITER tempat nama yang memenuhi syarat ditulis. Penunjuk harus mereferensikan objek XML Writer yang valid.
[in, optional] prefix
Penunjuk WS_XML_STRING ke awalan yang digunakan oleh nama yang memenuhi syarat. Jika nilai yang dirujuk oleh parameter ini adalah NULL , Penulis akan memilih awalan.
[in] localName
Penunjuk WS_XML_STRING ke nama lokal yang digunakan oleh nama yang memenuhi syarat. Panjangnya harus minimal satu karakter.
[in, optional] ns
Penunjuk WS_XML_STRING ke namespace yang digunakan untuk nama yang memenuhi syarat.
Jika tidak ada awalan yang ditentukan, Writer dapat menggunakan awalan dalam cakupan yang terikat ke namespace yang ditentukan atau dapat menghasilkan awalan dan menyertakan atribut XMLNS.
Jika prefiks ditentukan, Writer menggunakan awalan tersebut dan dapat menyertakan atribut XMLNS jika diperlukan untuk mengganti prefiks yang ada dalam cakupan.
[in, optional] error
Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.
Nilai kembali
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Satu atau beberapa argumen tidak valid. |
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
Keterangan
- Jika awalannya NULL, maka namespace tidak boleh NULL. Dalam hal ini penulis akan mencoba menemukan awalan dalam cakupan yang terikat ke namespace yang ditentukan. Jika awalan yang sesuai ditemukan, awalan tersebut akan digunakan. Jika tidak, Writer akan menghasilkan awalan dan menyisipkan atribut XMLNS pada elemen saat ini. Jika penulis tidak berada dalam elemen , maka fungsi akan mengembalikan WS_E_INVALID_FORMAT.
- Jika awalan bukan NULL dan namespace bukan NULL , Writer akan memverifikasi bahwa awalan saat ini terikat ke namespace yang ditentukan dan akan mengembalikan WS_E_INVALID_FORMAT jika tidak.
- Jika awalan bukan NULL dan namespace adalah NULL , Writer akan menggunakan awalan dan nama lokal untuk menulis nama yang memenuhi syarat.
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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk