Funzione WsRemoveNode (webservices.h)

Articolo
03/13/2024

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

Share via