WsFindAttribute, fonction (webservices.h)

Recherche dans les attributs de l’élément actuel un attribut avec le nom et l’espace de noms spécifiés et retourne son index qui peut être passé à WsReadStartAttribute.

Syntaxe

HRESULT WsFindAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
  [out]          ULONG               *attributeIndex,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] reader

Lecteur sur lequel trouver l’attribut.

[in] localName

Nom local de l’attribut à rechercher.

[in] ns

Espace de noms de l’attribut à rechercher.

[in] required

Si la valeur est TRUE et que l’attribut est introuvable, la fonction retourne WS_E_INVALID_FORMAT. (Voir Valeurs de retour des services Web Windows.) Si nécessaire est FALSE et que l’attribut est introuvable, la fonction retourne S_FALSE.

[out] attributeIndex

Si l’attribut est trouvé, l’index de l’attribut est retourné ici. Cet index peut ensuite être passé à WsReadStartAttribute.

[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

Si le lecteur n’est pas positionné sur un élément de début, il retourne WS_E_INVALID_OPERATION. (Voir Valeurs de retour des services Web Windows.)

L’index retourné ne correspond pas nécessairement à la position de l’attribut tel qu’il apparaît dans le document. Il identifie l’index de l’attribut correspondant dans le tableau d’attributs du WS_XML_ELEMENT_NODE. L’ordre des attributs de ce tableau peut différer de l’ordre dans lequel les attributs apparaissent dans le document.

Configuration requise