WsGetReaderNode-Funktion (webservices.h)

  • Artikel

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:

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