WsReadXmlBuffer-Funktion (webservices.h)

  • Artikel

Liest den aktuellen Knoten aus einem Leser in eine WS_XML_BUFFER.

Syntax

HRESULT WsReadXmlBuffer(
  [in]           WS_XML_READER *reader,
  [in]           WS_HEAP       *heap,
                 WS_XML_BUFFER **xmlBuffer,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Der Reader, aus dem in den XML-Puffer eingelesen werden soll.

[in] heap

Der Heap, aus dem der XML-Puffer zugeordnet werden soll.

xmlBuffer

Der XML-Puffer wird hier zurückgegeben.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen 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_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.

Hinweise

Wenn der Leser entweder an WS_XML_NODE_TYPE_BOF oder WS_XML_NODE_TYPE_ELEMENT positioniert werden muss.

Wenn der Reader an WS_XML_NODE_TYPE_BOF positioniert ist, wird das gesamte Dokument aus dem Reader in den XML-Puffer kopiert.

Wenn der Reader an WS_XML_NODE_TYPE_ELEMENT positioniert ist, werden das Element und alle untergeordneten Elemente in den XML-Puffer eingelesen.

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