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

Удаляет все экземпляры сопоставленного заголовка из сообщения.

Синтаксис

HRESULT WsRemoveMappedHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] message

Сообщение, в которое нужно задать заголовок.

Сообщение может находиться в любом состоянии, но WS_MESSAGE_STATE_EMPTY.

[in] headerName

Имя удаляемого сопоставленного заголовка.

[in, optional] error

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

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

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

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

Комментарии

Сообщение может содержать дополнительные сведения о транспорте, которые не являются частью конверта сообщения. Эти сведения, относящиеся к транспорту, могут предоставляться программным способом в виде заголовков объекта Message. Эта функция используется для удаления сопоставленных заголовков из объекта message. Он может использоваться реализацией настраиваемого канала для удаления сопоставленных заголовков перед отправкой сообщения.

Требования

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