WsMoveWriter-Funktion (webservices.h)

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.

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