Función WsGetReaderNode (webservices.h)

La función devuelve el nodo XML en la posición actual del lector XML.

Sintaxis

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

Parámetros

[in] xmlReader

Puntero al lector para el que se obtendrá el nodo actual. Debe ser un objeto WS_XML_READER válido.

node

Referencia a una estructura de WS_XML_NODE donde se devuelve el nodo actual.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
E_INVALIDARG	Uno o más argumentos no son válidos.

Comentarios

El campo nodeType del nodo nodo debe inspeccionarse para determinar el tipo de nodo devuelto. A continuación, el nodo se puede convertir a la estructura de datos adecuada para obtener los datos.

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

Los nodeTypes con estructuras extendidas incluyen:

• 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

El nodo devuelto no debe modificarse y solo es válido hasta que avance el lector. Para los atributos de un WS_XML_ELEMENT_NODE llamadores no debe esperar que los atributos aparezcan en un orden determinado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll