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
S_OK	Metode berhasil.
E_INVALIDARG	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).
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
E_FAIL	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

Lihat juga

IWSDXMLContext