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

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

  • Статья

Эта функция помечает заголовок как "понятый" приложением.

Набор заголовков является расширяемым, а получатель не может получить доступ к ассимиляции сообщений. Эта функция является методом получения приложений для того, чтобы довести до отправителя сообщение о том, что полученный заголовок прочитан и понят.

Примечание Эту функцию следует использовать только в том случае, если приложение получает сообщение о том, что заголовок должен быть понят и он не получил заголовок с помощью WsGetHeader или WsGetCustomHeader.

WS_MESSAGE_STATE должен находиться в наборе для WS_MESSAGE_STATE_READING. Видеть. Дополнительные сведения о WsCheckMustUnderstandHeaders .

 

Синтаксис

HRESULT WsMarkHeaderAsUnderstood(
  [in]           WS_MESSAGE                 *message,
  [in]           const WS_XML_NODE_POSITION *headerPosition,
  [in, optional] WS_ERROR                   *error
);

Параметры

[in] message

Указатель на объект Message с заголовком для пометки.

[in] headerPosition

Указатель на позицию элемента заголовка в сегменте заголовка XML.

[in, optional] error

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

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

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

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

Комментарии

Когда приложение считывает заголовок с помощью средства чтения XML, оно должно получить WS_XML_NODE_POSITION элемента заголовка и передать его в эту функцию. Сведения о том, как получить WS_XML_NODE_POSITION, см. в разделе WsGetReaderPosition.

Требования

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