Compartir a través de

Función WSDGenerateFaultEx (wsdutil.h)

  • Artículo

Genera un error soap.

Sintaxis

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

Parámetros

[in] pCode

Código de error soap.

A continuación se muestra la lista de posibles códigos de error. Para obtener una descripción de cada código de error, consulte el

Especificación soap versión 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Remitente

Receptor

[in] pSubCode

Subcódigo de error.

[in] pReasons

Estructura WSD_LOCALIZED_STRING_LIST que contiene una lista de códigos de motivo localizados.

[in] pszDetail

Contiene información de error específica de la aplicación que pertenece al error.

[out] ppFault

Estructura WSD_SOAP_FAULT que contiene el error generado. ppFault debe liberarse con una llamada a WSDFreeLinkedMemory.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes:

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_INVALIDARG
 pszCode o pReasons es NULL.
E_POINTER
 ppFault es NULL.

Observaciones

Los errores soap proporcionan una manera de comunicar información de error en los mensajes SOAP con errores. Los distintos protocolos de servicios web amplían los errores para proporcionar información de error contextual y, en algunos casos, como en WS-Eventing, los errores son una parte esperada de patrones de mensaje específicos, ya que el cliente determina si el dispositivo admite o no características específicas.

WSDAPI no implementa los siguientes subcódigos de error:

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • UnsupportedExpirationType
  • InvalidMessage
  • FilteringNotSupported

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdutil.h (incluya Wsdapi.h)
Library Wsdapi.lib
Archivo DLL Wsdapi.dll