Función WsMoveReader (webservices.h)

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

Esta función solo se puede usar en un lector que esté establecido en xmlBuffer.

Sintaxis

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

Parámetros

[in] reader

Puntero al objeto Lector XML con la posición que se va a mover. El puntero debe hacer referencia a un objeto WS_XML_READER válido y el valor lector al que se hace referencia no puede ser NULL.

[in] moveTo

Este enumerador especifica la dirección o la posición siguiente del lector en relación con la posición actual.

found

Indica que el movimiento especificado se ha realizado correctamente o no.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error 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_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
WS_E_INVALID_OPERATION	No se permite la operación debido al estado actual del objeto .

Comentarios

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. (Vea Valores devueltos de servicios web de Windows).

Esta función no se puede usar durante la canónica. Si se ha llamado a WsStartReaderCanonicalization , devolverá WS_E_INVALID_OPERATION.

Requisitos

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