Compartilhar via

Função WSDGenerateFaultEx (wsdutil.h)

  • Artigo

Gera uma falha SOAP.

Sintaxe

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

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 o

Especificação soap versão 1.2.

VersionMismatch

MustUnderstand

DataEncodingUnknown

Remetente

Receptor

[in] pSubCode

Um subcódigo de falha.

[in] pReasons

Uma estrutura WSD_LOCALIZED_STRING_LIST que contém uma lista de códigos de motivo localizados.

[in] pszDetail

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

[out] ppFault

Uma estrutura WSD_SOAP_FAULT que contém a falha gerada. 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 ou pReasons é 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