Fonction WsGetReaderNode (webservices.h)

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.

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 :

• WS_XML_NODE_TYPE_ELEMENT =>WS_XML_ELEMENT_NODE
• WS_XML_NODE_TYPE_TEXT =>WS_XML_TEXT_NODE
• WS_XML_NODE_TYPE_COMMENT =>WS_XML_COMMENT_NODE

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