WsGetXmlAttribute, fonction (webservices.h)

  • Article

Recherche l’attribut xml le plus proche dans l’étendue avec le localName spécifié et retourne sa valeur.
La valeur retournée est placée sur le tas spécifié.

Syntaxe

HRESULT WsGetXmlAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           WS_HEAP             *heap,
                 WCHAR               **valueChars,
  [out]          ULONG               *valueCharCount,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] reader

Lecteur pour lequel l’attribut xml sera recherché.

[in] localName

LocalName de l’attribut xml pour lequel effectuer la recherche.

[in] heap

Tas sur lequel la valeur résultante doit être allouée.

valueChars

La valeur de l’attribut est stockée ici.

[out] valueCharCount

Longueur de valueChars.

[in, optional] error

Spécifie l’emplacement où des 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
E_INVALIDARG
 Un ou plusieurs arguments ne sont pas valides.
S_FALSE
 L’attribut xml est introuvable.

Remarques

Cette fonction peut uniquement être utilisée pour obtenir les valeurs des attributs dans l’étendue qui utilisent le préfixe « xml ».

Si aucun attribut xml correspondant n’est trouvé, une chaîne de longueur nulle est retournée pour la valeur et la fonction retourne S_FALSE.

Le lecteur ne fait rien avec les attributs xml, sauf pour les exposer à des fins d’inspection.

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