WsMoveReader 函式 (webservices.h)

  • 發行項

移動 moveTo 參數所指定的讀取器目前位置。

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

語法

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

參數

[in] reader

XML 讀取器物件的指標，具有要移動的位置。 指標必須參考有效的WS_XML_READER物件 ， 而參考的 Reader 值可能不是 Null。

[in] moveTo

這個列舉值會指定讀取器相對於目前位置的方向或下一個位置。

found

表示指定移動的成功或失敗。

[in, optional] error

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

傳回值

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

傳回碼 描述
E_INVALIDARG
 一或多個引數無效。
WS_E_INVALID_FORMAT
 輸入資料的格式不正確，或沒有預期的值。
WS_E_INVALID_OPERATION
 由於 物件的目前狀態，不允許此作業。

備註

如果找到的參數不是 Null，則會指出它是否可以移至要求的節點並傳回 NOERROR。

如果找到的參數是 Null，而且找不到要求的節點，則會傳回 WS_E_INVALID_FORMAT。 (請參閱 Windows Web 服務傳回值。)

在標準化時，無法使用此函式。 如果已呼叫 WsStartReaderCanonicalization ，則會傳回 WS_E_INVALID_OPERATION。

規格需求

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