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

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

Синтаксис

HRESULT WSDGenerateFaultEx(
  [in]  WSDXML_NAME               *pCode,
  [in]  WSDXML_NAME               *pSubCode,
  [in]  WSD_LOCALIZED_STRING_LIST *pReasons,
  [in]  LPCWSTR                   pszDetail,
  [out] WSD_SOAP_FAULT            **ppFault
);

Параметры

[in] pCode

Код ошибки SOAP.

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

Спецификация SOAP версии 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Отправитель

Получатель

[in] pSubCode

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

[in] pReasons

Структура WSD_LOCALIZED_STRING_LIST , содержащая список локализованных кодов причин.

[in] pszDetail

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

[out] ppFault

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

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

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

Комментарии

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

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

• InvalidMessageInformationHeader
• MessageInformationHeaderRequired
• UnsupportedExpirationType
• InvalidMessage
• FilteringNotSupported

Требования