WsWriteQualifiedName-Funktion (webservices.h)

  • Artikel

Schreibt einen XML-qualifizierten Namen in den Writer.

Syntax

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

Ein Zeiger auf das WS_XML_WRITER-Objekt , in das der qualifizierte Name geschrieben wird. Der Zeiger muss auf ein gültiges XML Writer-Objekt verweisen.

[in, optional] prefix

Ein WS_XML_STRING Zeiger auf das Präfix, das vom qualifizierten Namen verwendet wird. Wenn der Wert, auf den durch diesen Parameter verwiesen wird , NULL ist, wählt der Writer ein Präfix aus.

[in] localName

Ein WS_XML_STRING Zeiger auf den lokalen Namen, der vom qualifizierten Namen verwendet wird. Es muss mindestens ein Zeichen lang sein.

[in, optional] ns

Ein WS_XML_STRING Zeiger auf den Namespace, der für den qualifizierten Namen verwendet wird.

Wenn kein Präfix angegeben ist, kann der Writer im Bereich ein Präfix verwenden, das an den angegebenen Namespace gebunden ist, oder er generiert ein Präfix und enthält ein XMLNS-Attribut.

Wenn ein Präfix angegeben wird, verwendet der Writer dieses Präfix und kann bei Bedarf ein XMLNS-Attribut enthalten, um ein vorhandenes Präfix im Bereich außer Kraft zu setzen.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
WS_E_INVALID_FORMAT
 Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.

Hinweise

  • Wenn das Präfix NULL ist, darf der Namespace nicht NULL sein. In diesem Fall versucht der Writer, ein Präfix im Bereich zu finden, das an den angegebenen Namespace gebunden ist. Wenn ein geeignetes Präfix gefunden wird, wird es verwendet. Andernfalls generiert der Writer ein Präfix und fügt ein XMLNS-Attribut in das aktuelle Element ein. Wenn sich der Writer nicht in einem Element befindet, gibt die Funktion WS_E_INVALID_FORMAT zurück.

    (Siehe Rückgabewerte für Windows-Webdienste.)

  • Wenn das Präfix nicht NULL und der Namespace nicht NULL ist, überprüft der Writer, ob das Präfix derzeit an den angegebenen Namespace gebunden ist, und gibt WS_E_INVALID_FORMAT zurück, wenn dies nicht der Fehler ist.
  • Wenn das Präfix nicht NULL und der Namespace NULL ist, verwendet der Writer das Präfix und den lokalen Namen, um den qualifizierten Namen zu schreiben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll