Compartilhar via


Função WsRemoveNode (webservices.h)

Remove o nó na posição especificada do buffer xml. Se posicionado em um elemento, ele removerá o elemento, incluindo todos os seus filhos e seu elemento final correspondente, caso contrário, removerá um único nó.

O uso de qualquer API com um WS_XML_READER ou WS_XML_WRITER que atualmente depende dessa posição ou de um filho dessa posição falhará. O WS_XML_READER ou WS_XML_WRITER deve ser reposicionado antes de usar mais.

Ele retornará WS_E_INVALID_OPERATION se o nó estiver posicionado em um elemento final ou na raiz do documento. (Consulte Valores retornados dos Serviços Web do Windows.)

Chamar WsSetReaderPosition ou WsSetWriterPosition depois de chamar WsRemoveNode falhará.

Sintaxe

HRESULT WsRemoveNode(
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

Parâmetros

[in] nodePosition

A posição do nó que deve ser removido.

[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
WS_E_INVALID_OPERATION
A operação não é permitida devido ao estado atual do objeto.

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