Compartir a través de

Función WSDGenerateFault (wsdutil.h)

  • Artículo

Genera un error soap.

Sintaxis

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

Parámetros

[in] pszCode

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 la especificación SOAP Versión 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Remitente

Receptor

[in] pszSubCode

Subcódigo de error.

[in] pszReason

Una explicación legible del error.

[in] pszDetail

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

[in] pContext

Interfaz IWSDXMLContext que representa el contexto en el que se va a generar el error.

[out] ppFault

Estructura WSD_SOAP_FAULT que contiene el error generado. Cuando la aplicación que realiza la llamada se realiza con estos datos, 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, pszReason o pContext 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