WsReadStartAttribute, fonction (webservices.h)

Article
03/03/2024

Déplace le lecteur vers l’attribut spécifié afin que le contenu puisse être lu à l’aide de WsReadValue, WsReadChars ou WsReadBytes.

Si le lecteur n’est pas positionné sur un élément de début, il retourne une exception WS_E_INVALID_FORMAT .

(Voir Valeurs de retour des services web Windows.)

Note Les attributs lus n’apparaissent pas dans un ordre particulier. WsFindAttribute peut être utilisé pour localiser l’index d’un attribut particulier.

Syntaxe

HRESULT WsReadStartAttribute(
  [in]           WS_XML_READER *reader,
  [in]           ULONG         attributeIndex,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] reader

Pointeur vers l’objet Lecteur XML utilisé pour lire l’attribut Start.

[in] attributeIndex

Index de l’attribut à lire.

[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.

Remarques

La fonction WsReadNode retourne EOF lorsqu’elle est avancée dans un attribut. La fonction WsReadEndAttribute peut être utilisée pour renvoyer le lecteur à l’élément contenant.

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

Partager via