Share via

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

  • Статья

Возвращает состояние сообщения в WS_MESSAGE_STATE_EMPTY. В этом состоянии объект Message можно использовать повторно.

Синтаксис

HRESULT WsResetMessage(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

Параметры

[in] message

Указатель на объект Message для сброса.

[in, optional] error

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

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

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

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

Комментарии

При сбросе сообщения сбрасывается его базовая куча.

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

Требования

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