WsSetReaderPosition 函式 (webservices.h)

設定讀取器的目前位置。 必須透過呼叫 WsGetReaderPositionWsGetWriterPosition 來取得位置。

此函式只能在設定為 WS_XML_BUFFER的讀取器上使用。

語法

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

參數

[in] reader

設定目前位置 之WS_XML_READER 物件的指標。 指標必須參考有效的 XML Reader 物件。

[in] nodePosition

要設定讀取器之位置的指標。

[in, optional] error

WS_ERROR 物件的指標,如果函式失敗,應該儲存錯誤的其他資訊。

傳回值

此函式可以傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
一或多個引數無效。
WS_E_INVALID_OPERATION
由於物件的目前狀態,不允許此作業。

備註

如需使用位置的詳細資訊 ,請參閱WS_XML_NODE_POSITION

此函式無法在標準化時使用。 如果已呼叫 WsStartReaderCanonicalization ,則會 傳回WS_E_INVALID_OPERATION。 (請參閱 Windows Web 服務傳回值。)

規格需求

需求
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll