WsWriteStartElement-Funktion (webservices.h)

  • Artikel

Schreibt ein Startelement in den Writer.

Nach dem Aufrufen dieser Funktion kann WsWriteStartAttribute oder WsWriteXmlnsAttribute aufgerufen werden, um zusätzliche Attribute in das Element zu schreiben. Das Element wird erst an den Writer gebunden, wenn WsWriteEndElement oder eine andere Funktion, die Inhalte schreibt, aufgerufen wird.

Syntax

HRESULT WsWriteStartElement(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

Ein Zeiger auf das WS_XML_WRITER-Objekt , in das das Startelement 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 für das Startelement verwendet werden soll. Wenn der Wert, auf den durch diesen Parameter verwiesen wird , NULL ist, wählt writer ein Attribut aus.

[in] localName

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

[in] ns

Ein WS_XML_STRING Zeiger auf den Namespace, der für das Startelement verwendet werden soll.

Wenn kein Präfix angegeben ist, kann der Writer ein Präfix im Bereich 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_OPERATION
 Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_INVALID_FORMAT
 Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
WS_E_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.

Hinweise

Wenn die zugrunde liegende Codierung leere Elemente unterstützt und das Element keinen Inhalt aufweist, wird ein leeres Element geschrieben.

Wenn ein nicht leeres Präfix mit einem leeren Namespace angegeben wird , wird WS_E_INVALID_FORMAT zurückgegeben.

Wenn das Schreiben des Startelements dazu führt , dass WS_XML_WRITER_PROPERTY_MAX_DEPTH überschritten wird , WS_E_QUOTA_EXCEEDED zurückgegeben wird. (Siehe Rückgabewerte für Windows-Webdienste.)

Wenn Sie WS_XML_WRITER_MTOM_ENCODING verwenden, ist es ein Fehler, ein Element mit dem localName "Include" aus dem Namespace zu schreiben"http://www.w3.org/2004/08/xop/include".

WsWriteStartAttribute kann auch verwendet werden, um einem Element ein Attribut hinzuzufügen, wenn der Writer mithilfe von WsMoveWriter oder WsSetWriterPosition auf einem Element positioniert ist.

Anforderungen

Anforderung Wert
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