WsGetReaderNode-Funktion (webservices.h)

Die Funktion gibt den XML-Knoten an der aktuellen Position des XML-Readers zurück.

Syntax

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

Parameter

[in] xmlReader

Ein Zeiger auf den Reader, für den der aktuelle Knoten abgerufen wird. Dies muss WS_XML_READER Objekt gültig sein.

node

Ein Verweis auf eine WS_XML_NODE-Struktur , in der der aktuelle Knoten zurückgegeben wird.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Hinweise

Das Feld nodeType des Knotenknotens sollte überprüft werden, um die Art des zurückgegebenen Knotens zu bestimmen. Der Knoten kann dann in die entsprechende Datenstruktur umgewandelt werden, um die Daten abzurufen.

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
    }
}

Zu den nodeTypes mit erweiterten Strukturen gehören:

• 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

Der zurückgegebene Knoten sollte nicht geändert werden und ist nur gültig, bis der Reader voranschreitet. Für die Attribute in einem WS_XML_ELEMENT_NODE Aufrufer nicht erwarten, dass die Attribute in einer bestimmten Reihenfolge angezeigt werden.

Anforderungen