Función WSDGenerateFault (wsdutil.h)

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