IWSDXMLContext::AddNamespace-Methode (wsdxml.h)

Erstellt ein -Objekt, das einen Namespace in einem XML-Kontext darstellt. Wenn der Namespace bereits vorhanden ist, wird kein neuer Namespace hinzugefügt, und das Namespaceobjekt für den vorhandenen Namen wird zurückgegeben.

Syntax

HRESULT AddNamespace(
  [in]  LPCWSTR          pszUri,
  [in]  LPCWSTR          pszSuggestedPrefix,
  [out] WSDXML_NAMESPACE **ppNamespace
);

Parameter

[in] pszUri

Der URI des Namespace.

[in] pszSuggestedPrefix

Das Namespacepräfix, das beim Generieren von XML verwendet werden soll. Wenn der Namespace bereits vorhanden ist, überschreibt pszSuggestedPrefix das Präfix, das derzeit dem Namespace zugeordnet ist. Der XML-Kontext kann ein anderes Namespacepräfix zuweisen. Das vom XML-Kontext zugewiesene Präfix hat Vorrang vor dem vorgeschlagenen Präfix. Das PreferredPrefix-Element der Struktur, auf die ppNamespace verweist, enthält das präfix, das vom XML-Kontext zugewiesen wird.

[out] ppNamespace

Zeiger auf die Adresse der WSDXML_NAMESPACE Struktur, die den Namespace darstellt. Sie müssen die Zuordnung von ppNamespace aufheben, indem Sie WSDFreeLinkedMemory aufrufen. Dieser Parameter ist optional.

Rückgabewert

Mögliche Rückgabewerte sind u. a. die folgenden:

Hinweise

Die zurückgegebene WSDXML_NAMESPACE-Struktur kann verwendet werden, um eine Zuordnung zwischen dem Namespacepräfix (wie durch pszSuggestedPrefix angegeben) und dem Namespace-URI (wie durch pszUri angegeben) zu erzwingen. Sobald diese Zuordnung eingerichtet wurde, erzeugt der XML-Generator XML mit dem angegebenen Namespacepräfix.

Sie können AddNamespace aufrufen, um die WSDXML_NAMESPACE-Struktur abzurufen, die erstellt wurde, als ein Namespace automatisch durch einen Aufruf von AddNameToNamespace generiert wurde.

Anforderungen

Weitere Informationen

IWSDXMLContext