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

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

  • Статья

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

Синтаксис

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

Параметры

[in] message

Указатель на инициализируемый объект Message. Message должен быть допустимым экземпляром объекта WS_MESSAGE , возвращаемым WsCreateMessage или WsCreateMessageForChannel , и не может иметь значение NULL.

[in] initialization

Определяет инициализацию сообщения.

Примечание Если для значения инициализации задано значение WS_REPLY_MESSAGE или WS_FAULT_MESSAGE сообщение адресуется автоматически.
 

[in, optional] sourceMessage

Указатель на объект сообщения, используемый для инициализации параметра сообщения . Это значение должно иметь значение NULL, если параметр инициализации не имеет значения WS_DUPLICATE_MESSAGE, WS_REPLY_MESSAGE или WS_FAULT_MESSAGE.

[in, optional] error

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

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

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

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

Комментарии

Первоначальный отправитель сообщения должен добавить заголовок действия в сообщение с помощью WsSetHeader.

Этот API должен вызываться перед вызовом WsWriteEnvelopeStart или WsWriteMessageStart для сообщения.

Требования

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