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

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

  • Статья

Находит ближайший xml-атрибут в область с указанным localName и возвращает его значение.
Возвращаемое значение помещается в указанную кучу.

Синтаксис

HRESULT WsGetXmlAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           WS_HEAP             *heap,
                 WCHAR               **valueChars,
  [out]          ULONG               *valueCharCount,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] reader

Средство чтения, для которого будет выполняться поиск атрибута xml.

[in] localName

LocalName атрибута xml, по которому выполняется поиск.

[in] heap

Куча, в которой должно быть выделено итоговое значение.

valueChars

Значение атрибута хранится здесь.

[out] valueCharCount

Длина valueChars.

[in, optional] error

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

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

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

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

Комментарии

Эта функция может использоваться только для получения значений атрибутов в область, использующих префикс "xml".

Если соответствующий xml-атрибут не найден, для значения возвращается строка нулевой длины, а функция возвращает S_FALSE.

Средство чтения не выполняет никаких действий с атрибутами XML, кроме как для их отображения для проверки.

Требования

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