WsMoveReader-Funktion (webservices.h)

  • Artikel

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

Diese Funktion kann nur für einen Reader verwendet werden, der auf einen XmlBuffer festgelegt ist.

Syntax

HRESULT WsMoveReader(
  [in]           WS_XML_READER *reader,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Ein Zeiger auf das XML Reader-Objekt mit der zu verschiebenden Position. Der Zeiger muss auf ein gültiges WS_XML_READER-Objekt verweisen, und der Reader-Wert , auf den verwiesen wird, ist möglicherweise nicht NULL.

[in] moveTo

Dieser Enumerator gibt die Richtung oder die nächste Position des Readers relativ zur aktuellen Position an.

found

Gibt den Erfolg oder Fehler der angegebenen Verschiebung an.

[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_FORMAT
 Die Eingabedaten hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.
WS_E_INVALID_OPERATION
 Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.

Hinweise

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. (Siehe Rückgabewerte für Windows-Webdienste.)

Diese Funktion kann nicht während der Kanonisierung verwendet werden. Wenn WsStartReaderCanonicalization aufgerufen wurde, wird WS_E_INVALID_OPERATION zurückgegeben.

Anforderungen

   
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