Função WsMoveReader (webservices.h)

Move a posição atual do leitor conforme especificado pelo parâmetro moveTo .

Essa função só pode ser usada em um leitor definido como um XmlBuffer.

Sintaxe

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

Parâmetros

[in] reader

Um ponteiro para o objeto Leitor de XML com a posição a ser movida. O ponteiro deve referenciar um objeto WS_XML_READER válido e o valor de Leitor referenciado pode não ser NULL.

[in] moveTo

Esse enumerador especifica a direção ou a próxima posição do Leitor em relação à posição atual.

found

Indica êxito ou falha da movimentação especificada.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função pode retornar um desses valores.

Código de retorno	Descrição
E_INVALIDARG	Um ou mais argumentos são inválidos.
WS_E_INVALID_FORMAT	Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
WS_E_INVALID_OPERATION	A operação não é permitida devido ao estado atual do objeto.

Comentários

Se o parâmetro encontrado não for NULL, ele indicará lá se ele pode ou não se mover para o nó solicitado e retornar NOERROR.

Se o parâmetro encontrado for NULL e o nó solicitado não for encontrado, ele retornará WS_E_INVALID_FORMAT. (Consulte Valores retornados dos Serviços Web do Windows.)

Essa função não pode ser usada durante a canonização. Se WsStartReaderCanonicalization tiver sido chamado, ele retornará WS_E_INVALID_OPERATION.

Requisitos

Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	webservices.h
Biblioteca	WebServices.lib
DLL	WebServices.dll