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

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

  • Статья

Выполняет поиск атрибута с указанным именем и пространством имен в атрибутах текущего элемента и возвращает его индекс, который может быть передан в WsReadStartAttribute.

Синтаксис

HRESULT WsFindAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
  [out]          ULONG               *attributeIndex,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] reader

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

[in] localName

Локальное имя атрибута для поиска.

[in] ns

Пространство имен атрибута для поиска.

[in] required

Если требуется значение TRUE и атрибут не найден, функция вернет WS_E_INVALID_FORMAT. (См. раздел Возвращаемые значения веб-служб Windows.) Если требуется значение FALSE и атрибут не найден, функция вернет S_FALSE.

[out] attributeIndex

Если атрибут найден, сюда возвращается индекс атрибута. Затем этот индекс можно передать в WsReadStartAttribute.

[in, optional] error

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

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

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

Код возврата Описание
WS_E_INVALID_FORMAT
 Входные данные не были в ожидаемом формате или не имели ожидаемого значения.

Комментарии

Если средство чтения не расположено на элементе start, оно вернет WS_E_INVALID_OPERATION. (См. раздел Возвращаемые значения веб-служб Windows.)

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

Требования

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