Função WsSetReaderPosition (webservices.h)

Define a posição atual do Leitor. A posição deve ter sido obtida por uma chamada para WsGetReaderPosition ou WsGetWriterPosition.

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

Sintaxe

HRESULT WsSetReaderPosition(
  [in]           WS_XML_READER              *reader,
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

Parâmetros

[in] reader

Um ponteiro para o objeto WS_XML_READER para o qual a posição atual está definida. O ponteiro deve referenciar um objeto XML Reader válido.

[in] nodePosition

Um ponteiro para a posição para definir o Leitor.

[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.

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.

Comentários

Consulte WS_XML_NODE_POSITION para obter mais informações sobre como usar posições.

Essa função não pode ser usada durante a canonização. Se WsStartReaderCanonicalization tiver sido chamado, ele retornará WS_E_INVALID_OPERATION. (Consulte Valores retornados dos Serviços Web do Windows.)

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