IWSDXMLContext::AddNameToNamespace-Methode (wsdxml.h)

  • Artikel

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

Syntax

HRESULT AddNameToNamespace(
  [in]  LPCWSTR     pszUri,
  [in]  LPCWSTR     pszName,
  [out] WSDXML_NAME **ppName
);

Parameter

[in] pszUri

Der URI des XML-Namespace, in dem dieser Name erstellt wird. Wenn dieser Namespace noch nicht im XML-Kontext vorhanden ist, wird automatisch eine neue Namespacestruktur generiert.

[in] pszName

Der Name, der dem durch pszUri angegebenen Namespace hinzugefügt werden soll.

[out] ppName

Eine WSDXML_NAME-Struktur für den neu erstellten Namen. Sie müssen ppName durch Aufrufen von WSDFreeLinkedMemory behandeln. Dieser Parameter ist optional.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG
 pszUri ist NULL , oder die Länge in Zeichen der URI-Zeichenfolge überschreitet WSD_MAX_TEXT_LENGTH (8192). pszName ist NULL , oder die Länge in Zeichen der Namenszeichenfolge überschreitet WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
E_FAIL
 Fehler bei der Methode.

Hinweise

AddNameToNamespace kann beim Erstellen von XML-Elementen für erweiterbare Abschnitte verwendet werden. Erweiterbare Abschnitte werden durch das beliebige Element in einem Schema dargestellt. Die zurückgegebene WSDXML_NAME Struktur, auf die von ppName verwiesen wird, kann verwendet werden, um den Namen anzugeben, der dem Erweiterungsinhalt zugeordnet ist. Verwenden Sie beim Erstellen einer WSDXML_ELEMENT-Struktur , die Erweiterungsinhalt darstellt, die zurückgegebene WSDXML_NAME-Struktur für das Name-Element des Elements.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wsdxml.h (einschließen von Wsdapi.h)
DLL Wsdapi.dll

Weitere Informationen

IWSDXMLContext