Funzione WsGetReaderNode (webservices.h)

Articolo
03/09/2024

La funzione restituisce il nodo XML nella posizione corrente del lettore XML.

Sintassi

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

Parametri

[in] xmlReader

Puntatore al lettore per il quale verrà ottenuto il nodo corrente. Deve essere un oggetto WS_XML_READER valido.

node

Riferimento a una struttura WS_XML_NODE in cui viene restituito il nodo corrente.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.

Commenti

Il campo nodeType del nodo deve essere controllato per determinare il tipo di nodo restituito. È quindi possibile eseguire il cast del nodo alla struttura di dati appropriata per ottenere i dati.

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

I nodeType con strutture estese includono:

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

Il nodo restituito non deve essere modificato ed è valido solo fino a quando il lettore non avanza. Per gli attributi in un WS_XML_ELEMENT_NODE i chiamanti non devono aspettarsi che gli attributi vengano visualizzati in un ordine specifico.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Share via