WsGetReaderNode-Funktion (webservices.h)

Artikel
03/03/2024

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.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über