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

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

  • Статья

Эта функция заполняет параметр ULONG WS_HEADER_ATTRIBUTES из элемента заголовка, в котором размещается средство чтения. Версия конверта сообщения используется для определения возвращаемых атрибутов.

Синтаксис

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Параметры

[in] message

Указатель на структуру WS_MESSAGE , содержащую сообщение для запроса. Эта версия конверта сообщения используется для определения соответствия атрибутов. Сообщение может находиться в любом состоянии, кроме WS_MESSAGE_STATE_EMPTY.

[in] reader

Указатель на средство чтения для запроса. Он должен быть допустимым WS_XML_READER объекте, возвращаемом из WsCreateReader , и не может иметь значение NULL.

[out] headerAttributes

При успешном выполнении значение, на которое ссылается этот указатель, присваивается атрибутам заголовка.

[in, optional] error

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

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

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

Код возврата Описание
E_OUTOFMEMORY
 Не хватает памяти.
E_INVALIDARG
 Один или несколько аргументов недопустимы.
WS_E_INVALID_FORMAT
 Входные данные не были в ожидаемом формате или не имели ожидаемого значения.
Другие ошибки
Эта функция может возвращать другие ошибки, не перечисленные выше.

Комментарии

Предполагается, что средство чтения указывает на элемент заголовка. Используйте API чтения XML, чтобы правильно разместить средство чтения.

Требования

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