Compartilhar via

Função WSDGenerateFault (wsdutil.h)

  • Artigo

Gera uma falha SOAP.

Sintaxe

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

Um código de falha SOAP.

A lista de possíveis códigos de falha a seguir. Para obter uma descrição de cada código de falha, consulte a especificação soap versão 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Remetente

Receptor

[in] pszSubCode

Um subcódigo de falha.

[in] pszReason

Uma explicação legível da falha.

[in] pszDetail

Contém informações de erro específicas do aplicativo relativas à falha.

[in] pContext

Uma interface IWSDXMLContext que representa o contexto no qual gerar a falha.

[out] ppFault

Uma estrutura WSD_SOAP_FAULT que contém a falha gerada. Quando o aplicativo de chamada é feito com esses dados, ppFault deve ser liberado com uma chamada para WSDFreeLinkedMemory.

Valor retornado

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte:

Código de retorno Descrição
S_OK
 Método concluído com êxito.
E_INVALIDARG
 pszCode, pszReason ou pContext é NULL.
E_POINTER
 ppFault é NULL.

Comentários

Falhas soap fornecem uma maneira de comunicar informações de erro em mensagens SOAP com falha. Diferentes protocolos de Serviços Web estendem falhas para fornecer informações de erro contextuais e, em alguns casos, como no WS-Eventing, as falhas são uma parte esperada de padrões de mensagem específicos, pois o cliente determina se o dispositivo dá suporte ou não a recursos específicos.

Os seguintes subcódigos de falha não são implementados pelo WSDAPI:

  • InvalidMessageInformationHeader
  • MessageInformationHeaderRequired
  • UnsupportedExpirationType
  • InvalidMessage
  • FilteringNotSupported

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wsdutil.h (inclua Wsdapi.h)
Biblioteca Wsdapi.lib
DLL Wsdapi.dll