WsGetXmlAttribute, fonction (webservices.h)

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.

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