Поделиться через

Функция 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_ELEMENT_NODE вызывающие не должны ожидать, что атрибуты будут отображаться в определенном порядке.

Требования

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