WsSetReaderPosition-Funktion (webservices.h)

  • Artikel

Legt die aktuelle Position des Readers fest. Die Position muss durch einen Aufruf von WsGetReaderPosition oder WsGetWriterPosition abgerufen worden sein.

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

Syntax

HRESULT WsSetReaderPosition(
  [in]           WS_XML_READER              *reader,
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

Parameter

[in] reader

Ein Zeiger auf das WS_XML_READER-Objekt , für das die aktuelle Position festgelegt ist. Der Zeiger muss auf ein gültiges XML Reader-Objekt verweisen.

[in] nodePosition

Ein Zeiger auf die Position, an der der Reader festgelegt werden soll.

[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_OPERATION
 Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.

Hinweise

Weitere Informationen zur Verwendung von Positionen finden Sie unter WS_XML_NODE_POSITION .

Diese Funktion kann nicht während der Kanonisierung verwendet werden. Wenn WsStartReaderCanonicalization aufgerufen wurde, wird WS_E_INVALID_OPERATION zurückgegeben. (Siehe Rückgabewerte für Windows-Webdienste.)

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