WsRemoveNode-Funktion (webservices.h)

  • Artikel

Entfernt den Knoten an der angegebenen Position aus dem XML-Puffer. Wenn es auf einem Element positioniert ist, entfernt es das Element einschließlich aller untergeordneten Elemente und des entsprechenden Endelements, andernfalls wird ein einzelner Knoten entfernt.

Die Verwendung einer beliebigen API mit einer WS_XML_READER oder WS_XML_WRITER , die derzeit von dieser Position oder einem untergeordneten Element dieser Position abhängig ist, schlägt fehl. Die WS_XML_READER oder WS_XML_WRITER muss vor der weiteren Verwendung neu positioniert werden.

Es wird WS_E_INVALID_OPERATION zurückgegeben, wenn der Knoten auf einem Endelement oder im Stammverzeichnis des Dokuments positioniert ist. (Siehe Rückgabewerte für Windows-Webdienste.)

Das Aufrufen von WsSetReaderPosition oder WsSetWriterPosition nach dem Aufruf von WsRemoveNode schlägt fehl.

Syntax

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

Parameter

[in] nodePosition

Die Position des Knotens, der entfernt werden soll.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
WS_E_INVALID_OPERATION
 Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll