Función WsMoveWriter (webservices.h)

Mueve la posición actual del escritor según lo especificado por el parámetro moveTo.

Sintaxis

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

Parámetros

[in] writer

Escritor que se va a mover.

[in] moveTo

Posición relativa para mover el escritor.

found

Si no es NULL, aquí se devuelve si se puede mover o no la nueva posición a .

Si es NULL y la posición no se pudo mover a, la función devolverá WS_E_INVALID_FORMAT. (Consulte Valores devueltos de servicios web de Windows).

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
E_INVALIDARG	Uno o más argumentos no son válidos.
WS_E_INVALID_OPERATION	No se permite la operación debido al estado actual del objeto .
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.

Comentarios

Esto solo se puede usar en un escritor que esté establecido en un WS_XML_BUFFER.

Si el parámetro encontrado no es NULL, indicará allí si podría moverse o no al nodo solicitado y devolver NOERROR.

Si el parámetro encontrado es NULL y no se encuentra el nodo solicitado, devolverá WS_E_INVALID_FORMAT.

Una vez colocado, el escritor insertará nuevos datos antes de la posición especificada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll