Compartilhar via


Função WsMoveWriter (webservices.h)

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

Sintaxe

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

Parâmetros

[in] writer

O gravador a ser movido.

[in] moveTo

A posição relativa para mover o gravador.

found

Se isso não for NULL, se a nova posição pode ou não ser movida para será retornada aqui.

Se for NULL e a posição não puder ser movida para, a função retornará WS_E_INVALID_FORMAT. (Consulte Valores retornados dos Serviços Web do Windows.)

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

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_OPERATION
A operação não é permitida devido ao estado atual do objeto.
WS_E_INVALID_FORMAT
Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.

Comentários

Isso só pode ser usado em um gravador definido como um WS_XML_BUFFER.

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.

Depois de posicionado, o gravador inserirá novos dados antes da posição especificada.

Requisitos

Requisito Valor
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