WsCopyNode-Funktion (webservices.h)

  • Artikel

Kopiert den aktuellen Knoten aus dem angegebenen XML-Reader in den angegebenen XML-Writer.

Syntax

HRESULT WsCopyNode(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_XML_READER *reader,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Zeiger auf den WS_XML_WRITER , auf den der XML-Knoten kopiert werden soll.

[in] reader

Zeiger auf den WS_XML_READER , aus dem der XML-Knoten kopiert werden soll.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Beschreibung
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 der aktuelle Knotentyp WS_XML_NODE_TYPE_ELEMENT ist, werden der aktuelle Knoten, alle untergeordneten Elemente und das entsprechende Endelement in den XML-Writer kopiert.

Wenn der aktuelle Knotentyp WS_XML_NODE_TYPE_BOF ist, werden Knoten kopiert, bis ein Knoten vom Typ WS_XML_NODE_TYPE_EOF erreicht ist. Informationen zu Knotentypen finden Sie in der WS_XML_NODE_TYPE-Enumeration .

Der Reader wird auf dem Knoten positioniert, nachdem der Knoten kopiert wurde.

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