Функция WsGetReaderNode (webservices.h)

Функция возвращает узел XML в текущей позиции средства чтения XML.

Синтаксис

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

Параметры

[in] xmlReader

Указатель на модуль чтения, для которого будет получен текущий узел. Это должно быть допустимо WS_XML_READER объекте .

node

Ссылка на структуру WS_XML_NODE , в которой возвращается текущий узел.

[in, optional] error

Указатель на объект WS_ERROR , в котором должны храниться дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата	Описание
E_INVALIDARG	Один или несколько аргументов недопустимы.

Комментарии

Поле nodeTypeузла должно быть проверено, чтобы определить тип возвращаемого узла. Затем узел может быть приведен к соответствующей структуре данных для получения данных.

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

Типы узлов с расширенными структурами:

• 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

Возвращаемый узел не должен быть изменен и действителен только до тех пор, пока средство чтения не перейдет вперед. Для атрибутов в WS_XML_ELEMENT_NODE вызывающие не должны ожидать, что атрибуты будут отображаться в определенном порядке.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	webservices.h
Библиотека	WebServices.lib
DLL	WebServices.dll