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

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

  • Статья

Создает WS_FAULT из указанного объекта ошибки.

Синтаксис

HRESULT WsCreateFaultFromError(
  [in]  WS_ERROR            *error,
  [in]  HRESULT             faultErrorCode,
  [in]  WS_FAULT_DISCLOSURE faultDisclosure,
  [in]  WS_HEAP             *heap,
  [out] WS_FAULT            *fault
);

Параметры

[in] error

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

[in] faultErrorCode

Код ошибки HRESULT, возвращенный функцией, которая завершилась сбоем. Значение HRESULT не может быть кодом успешного выполнения.

Этот код ошибки никогда не включается в сбой напрямую, но используется в качестве резервного механизма для создания строки сбоя, если объект error не содержит строк ошибок.

[in] faultDisclosure

WS_FAULT_DISCLOSURE перечисление, определяющее, какие сведения копируются из объекта error в объект fault.

[in] heap

Указатель на структуру WS_HEAP , представляющую кучу , из которой выделяется память для возвращенного объекта сбоя.

[out] fault

Указатель на структуру WS_FAULT , представляющую возвращенный объект сбоя. Поля объекта сбоя являются хорошими до вызова WsFreeHeap или WsResetHeap для освобождения указанных ресурсов кучи.

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

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

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

Комментарии

Если объект ошибки содержит ошибку (то есть WS_FAULT_ERROR_PROPERTY_FAULT значение WS_FAULT_ERROR_PROPERTY_ID не равно NULL), то эта ошибка выбирается для создания возвращенного сбоя.

Если объект ошибки не содержит ошибку (WS_FAULT_ERROR_PROPERTY_FAULT имеет значение NULL), то для создания возвращенной ошибки выбирается универсальный сбой с универсальным кодом ошибки (без текста причины).

Если выбранный сбой не содержит ни одного текста причины, текст причины сбоя создается в соответствии со значением параметра раскрытия :

  • WS_FULL_FAULT_DISCLOSURE Все строки ошибок, присутствующие в объекте error, добавляются вместе, чтобы сформировать текст причины. Если строк нет, используется строка, связанная с параметром errorCode .
  • WS_MINIMAL_FAULT_DISCLOSURE используется общая строка ошибки.

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

Требования

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