WsFindAttribute, fonction (webservices.h)

  • Article

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.

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

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

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