Функция WSDGenerateFault (wsdutil.h)

Создает ошибку SOAP.

Синтаксис

HRESULT WSDGenerateFault(
  [in]  LPCWSTR        pszCode,
  [in]  LPCWSTR        pszSubCode,
  [in]  LPCWSTR        pszReason,
  [in]  LPCWSTR        pszDetail,
  [in]  IWSDXMLContext *pContext,
  [out] WSD_SOAP_FAULT **ppFault
);

Параметры

[in] pszCode

Код ошибки SOAP.

Ниже приведен список возможных кодов сбоя. Описание каждого кода ошибки см. в спецификации SOAP версии 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Отправитель

Получатель

[in] pszSubCode

Вложенный код ошибки.

[in] pszReason

Понятное объяснение ошибки.

[in] pszDetail

Содержит сведения об ошибках конкретного приложения, относящиеся к ошибке.

[in] pContext

Интерфейс IWSDXMLContext , представляющий контекст, в котором создается ошибка.

[out] ppFault

Структура WSD_SOAP_FAULT , содержащая сгенерированный сбой. После завершения работы вызывающего приложения с данными ppFault должен быть освобожден с помощью вызова WSDFreeLinkedMemory.

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

Возможные возвращаемые значения включают, помимо прочего, следующие:

Код возврата	Описание
S_OK	Метод успешно завершен.
E_INVALIDARG	pszCode, pszReason или pContext имеет значение NULL.
E_POINTER	PpFault имеет значение NULL.

Комментарии

Ошибки SOAP предоставляют способ передачи сведений об ошибках в сообщениях SOAP о сбоях. Различные протоколы веб-служб расширяют сбои, предоставляя контекстные сведения об ошибках, и в некоторых случаях, например при WS-Eventing, ошибки являются ожидаемой частью определенных шаблонов сообщений, так как клиент определяет, поддерживает ли устройство определенные функции.

WSDAPI не реализует следующие подкоды ошибок:

• InvalidMessageInformationHeader
• MessageInformationHeaderRequired
• UnsupportedExpirationType
• InvalidMessage
• FilteringNotSupported

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wsdutil.h (включая Wsdapi.h)
Библиотека	Wsdapi.lib
DLL	Wsdapi.dll