Fonction WsReadAttribute (webservices.h)

Article
03/03/2024

Lisez un attribut produisant une valeur du WS_TYPE spécifié.

Syntaxe

HRESULT WsReadAttribute(
  [in]           WS_XML_READER                  *reader,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_READ_OPTION                 readOption,
  [in, optional] WS_HEAP                        *heap,
                 void                           *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

Paramètres

[in] reader

Lecteur positionné sur l’élément contenant l’attribut.

[in] attributeDescription

Pointeur vers une description de la désérialisation de l’attribut.

[in] readOption

Indique si l’attribut est requis et comment allouer la valeur. Pour plus d’informations , consultez WS_READ_OPTION .

[in, optional] heap

Tas dans lequel stocker les valeurs désérialisées.

value

L’interprétation de ce paramètre dépend du WS_READ_OPTION.

[in] valueSize

L’interprétation de ce paramètre dépend du WS_READ_OPTION.

[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_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
E_OUTOFMEMORY	Nous avons manqué de mémoire.
WS_E_QUOTA_EXCEEDED	Le quota de taille du tas a été dépassé.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.

Remarques

Cette API recherche l’attribut en fonction du nom et de l’espace de noms, puis désérialise le contenu en tant que valeur typée.

Si l’API échoue, l’état du lecteur d’entrée devient non défini. Les seules API qui peuvent être utilisées sur le lecteur si cela se produit sont WsSetInput et WsSetInputToBuffer pour renvoyer le lecteur à un état utilisable, ou WsFreeReader pour libérer le lecteur.

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