Funzione WsRemoveNode (webservices.h)

  • Articolo

Rimuove il nodo nella posizione specificata dal buffer xml. Se posizionato su un elemento rimuoverà l'elemento incluso tutti i relativi elementi figlio e il relativo elemento finale corrispondente, in caso contrario, rimuoverà un singolo nodo.

L'uso di qualsiasi API con un WS_XML_READER o WS_XML_WRITER che attualmente dipende da questa posizione o da un elemento figlio di questa posizione avrà esito negativo. Il WS_XML_READER o WS_XML_WRITER deve essere riposizionato prima di usare ulteriormente.

Restituirà WS_E_INVALID_OPERATION se il nodo è posizionato su un elemento finale o sulla radice del documento. Vedere Valori restituiti da Servizi Web Windows.

La chiamata a WsSetReaderPosition o WsSetWriterPosition dopo la chiamata a WsRemoveNode avrà esito negativo.

Sintassi

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

Parametri

[in] nodePosition

Posizione del nodo da rimuovere.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
WS_E_INVALID_OPERATION
 L'operazione non è consentita a causa dello stato corrente dell'oggetto.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione webservices.h
Libreria WebServices.lib
DLL WebServices.dll