WsRemoveNode, fonction (webservices.h)

Article
03/03/2024

Supprime le nœud à la position spécifiée de la mémoire tampon xml. S’il est positionné sur un élément, il supprime l’élément, y compris tous ses enfants et son élément de fin correspondant, sinon, il supprime un nœud unique.

L’utilisation de n’importe quelle API avec un WS_XML_READER ou un WS_XML_WRITER qui dépend actuellement de cette position ou d’un enfant de cette position échouera. Le WS_XML_READER ou le WS_XML_WRITER doit être repositionné avant d’utiliser davantage.

Il retourne WS_E_INVALID_OPERATION si le nœud est positionné sur un élément de fin ou la racine du document. (Voir Valeurs de retour des services web Windows.)

L’appel de WsSetReaderPosition ou WsSetWriterPosition après l’appel de WsRemoveNode échoue.

Syntaxe

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

Paramètres

[in] nodePosition

Position du nœud à supprimer.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
WS_E_INVALID_OPERATION	L’opération n’est pas autorisée en raison de l’état actuel de l’objet.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Share via