WsReadNode, fonction (webservices.h)

  • Article

Cette opération avance le lecteur vers le nœud suivant dans le flux d’entrée. En cas d’erreur lors de l’analyse de l’entrée, la fonction retourne WS_E_INVALID_FORMAT. (Voir Valeurs de retour des services Web Windows.)

Syntaxe

HRESULT WsReadNode(
  [in]           WS_XML_READER *reader,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] reader

Pointeur vers l’objet Lecteur XML à avancer. Le pointeur doit référencer un WS_XML_READER valide et il ne peut pas être NULL.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur 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_FORMAT
 Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue, ou plusieurs éléments de niveau supérieur ont été trouvés et WS_XML_READER_PROPERTY_ALLOW_FRAGMENT a la valeur FALSE.
WS_E_QUOTA_EXCEEDED
 Un élément qui a dépassé une limite telle que WS_XML_READER_PROPERTY_MAX_DEPTH ou WS_XML_READER_PROPERTY_MAX_ATTRIBUTES a été lu.

Remarques

D’autres conditions d’exception sont les suivantes :

  • Si une déclaration XML est trouvée et que WS_XML_READER_PROPERTY_READ_DECLARATION a la valeur FALSE, WS_E_INVALID_FORMAT est retourné.
  • Si le lecteur utilise WS_XML_READER_STREAM_INPUT et que les données mises en mémoire tampon étaient insuffisantes, le lecteur retourne WS_E_QUOTA_EXCEEDED.

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