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

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

  • Статья

Создает сообщение для использования с указанным каналом.

Синтаксис

HRESULT WsCreateMessageForChannel(
  [in]           WS_CHANNEL                *channel,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Параметры

[in] channel

Указатель на структуру WS_CHANNEL , представляющую канал для сообщения.

properties

Массив необязательных свойств сообщения. См . WS_MESSAGE_PROPERTY.

Значение этого параметра может иметь значение NULL. В этом случае параметр propertyCount должен иметь значение 0 (ноль).

[in] propertyCount

Число свойств в массиве свойств .

message

При успешном выполнении указатель, получающий адрес WS_MESSAGE структуры, представляющей новое сообщение.

Если эта структура больше не нужна, ее необходимо освободить, вызвав WsFreeMessage.

[in, optional] error

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

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

Если функция выполняется успешно, она возвращает NO_ERROR; В противном случае возвращается код ошибки HRESULT.

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

Комментарии

В отличие от более общей функции WsCreateMessage , WsCreateMessageForChannel гарантирует, что используемая версия сообщения подходит для канала.

Требования

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