Поделиться через


Функция WsMoveWriter (webservices.h)

Перемещает текущую позицию модуля записи в соответствии с параметром moveTo.

Синтаксис

HRESULT WsMoveWriter(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Параметры

[in] writer

Модуль записи для перемещения.

[in] moveTo

Относительное положение для перемещения модуля записи.

found

Если это значение не равно NULL, сюда возвращается значение, указывающее, можно ли переместить новую позицию.

Если значение равно NULL и не удалось переместить позицию, функция вернет WS_E_INVALID_FORMAT. (См. раздел Возвращаемые значения веб-служб Windows.)

[in, optional] error

Указывает, где должны храниться дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата Описание
E_INVALIDARG
Один или несколько аргументов являются недопустимыми.
WS_E_INVALID_OPERATION
Операция не разрешена из-за текущего состояния объекта .
WS_E_INVALID_FORMAT
Входные данные не были в ожидаемом формате или не имели ожидаемого значения.

Комментарии

Его можно использовать только для модуля записи, для WS_XML_BUFFER.

Если найденный параметр не равен NULL, он указывает, может ли он переместиться на запрошенный узел и возвратить NOERROR.

Если параметр found имеет значение NULL, а запрошенный узел не найден, он вернет WS_E_INVALID_FORMAT.

После позиционирования модуль записи вставляет новые данные перед указанной позицией.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll