Metode IWSDXMLContext::AddNamespace (wsdxml.h)
Membuat objek yang mewakili namespace dalam konteks XML. Jika namespace sudah ada, tidak ada namespace baru yang akan ditambahkan, dan objek namespace untuk nama yang ada akan dikembalikan.
Sintaks
HRESULT AddNamespace(
[in] LPCWSTR pszUri,
[in] LPCWSTR pszSuggestedPrefix,
[out] WSDXML_NAMESPACE **ppNamespace
);
Parameter
[in] pszUri
URI namespace layanan.
[in] pszSuggestedPrefix
Awalan namespace yang akan digunakan saat menghasilkan XML. Jika namespace sudah ada, pszSuggestedPrefix akan menimpa awalan yang saat ini terkait dengan namespace. Konteks XML dapat menetapkan awalan namespace yang berbeda. Awalan yang ditetapkan oleh konteks XML lebih diutamakan daripada awalan yang disarankan. Anggota PreferredPrefix dari struktur yang ditujukkan oleh ppNamespace berisi awalan yang ditetapkan oleh konteks XML.
[out] ppNamespace
Arahkan ke alamat struktur WSDXML_NAMESPACE yang mewakili namespace. Anda harus membatalkan alokasi ppNamespace dengan memanggil WSDFreeLinkedMemory. Parameter ini bersifat opsional.
Mengembalikan nilai
Nilai yang mungkin dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
pszUri adalah NULL, panjang karakter string URI melebihi WSD_MAX_TEXT_LENGTH (8192), pszSuggestedPrefix adalah NULL, atau panjang karakter string awalan melebihi WSD_MAX_TEXT_LENGTH (8192). |
|
Tidak cukup memori untuk menyelesaikan operasi. |
|
Metode gagal. |
Keterangan
Struktur WSDXML_NAMESPACE yang dikembalikan dapat digunakan untuk memaksa asosiasi antara awalan namespace (seperti yang ditentukan oleh pszSuggestedPrefix) dan URI namespace (seperti yang ditentukan oleh pszUri). Setelah asosiasi ini dibuat, generator XML akan menghasilkan XML dengan awalan namespace yang ditentukan.
Anda dapat memanggil AddNamespace untuk mengambil struktur WSDXML_NAMESPACE yang dibuat saat namespace secara otomatis dihasilkan oleh panggilan ke AddNameToNamespace.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wsdxml.h (termasuk Wsdapi.h) |
DLL | Wsdapi.dll |