Fonction WsGetReaderNode (webservices.h)

  • Article

La fonction retourne le nœud XML à la position actuelle du lecteur XML.

Syntaxe

HRESULT WsGetReaderNode(
  [in]           WS_XML_READER     *xmlReader,
                 const WS_XML_NODE **node,
  [in, optional] WS_ERROR          *error
);

Paramètres

[in] xmlReader

Pointeur vers le lecteur pour lequel le nœud actuel sera obtenu. Cela doit être valide WS_XML_READER objet.

node

Référence à une structure WS_XML_NODE où le nœud actuel est retourné.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur 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.

Remarques

Le champ nodeType du nœud doit être inspecté pour déterminer le type de nœud retourné. Le nœud peut ensuite être converti dans la structure de données appropriée pour obtenir les données.

WS_XML_NODE* node;
if (SUCCEEDED(WsGetReaderNode(reader, &node, error)))
{
    if (node->nodeType == WS_XML_NODE_TYPE_ELEMENT)
    {
        WS_XML_ELEMENT_NODE* elementNode = (WS_XML_ELEMENT_NODE*) node;
        // Refer to elementNode->localName, elementNode->ns
    }
}

Les nodeTypes avec des structures étendues sont les suivants :

Le nœud retourné ne doit pas être modifié et n’est valide que jusqu’à ce que le lecteur avance. Pour les attributs d’un WS_XML_ELEMENT_NODE les appelants ne doivent pas s’attendre à ce que les attributs apparaissent dans un ordre particulier.

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