WsMoveWriter-Funktion (webservices.h)

Artikel
03/03/2024

Verschiebt die aktuelle Position des Writers, wie durch den moveTo-Parameter angegeben.

Syntax

HRESULT WsMoveWriter(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Der zu verschiebende Writer.

[in] moveTo

Die relative Position, an der der Writer verschoben werden soll.

found

Wenn dies nicht NULL ist, wird hier zurückgegeben, ob die neue Position verschoben werden kann.

Wenn dies NULL ist und die Position nicht verschoben werden konnte, gibt die Funktion WS_E_INVALID_FORMAT zurück. (Siehe Rückgabewerte für Windows-Webdienste.)

[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_INVALID_FORMAT	Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.

Hinweise

Dies kann nur für einen Writer verwendet werden, der auf eine WS_XML_BUFFER festgelegt ist.

Wenn der gefundene Parameter nicht NULL ist, wird dort angegeben, ob er zum angeforderten Knoten verschoben werden kann und NOERROR zurückgibt.

Wenn der gefundene Parameter NULL ist und der angeforderte Knoten nicht gefunden wird, wird WS_E_INVALID_FORMAT zurückgegeben.

Nach der Position fügt der Writer dann neue Daten vor der angegebenen Position ein.

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

Freigeben über