estrutura WS_FAULT (webservices.h)

  • Artigo

Uma Falha é um valor carregado no corpo de uma mensagem que transmite uma falha de processamento. As falhas são modeladas usando a estrutura WS_FAULT .

Sintaxe

typedef struct _WS_FAULT {
  WS_FAULT_CODE   *code;
  WS_FAULT_REASON *reasons;
  ULONG           reasonCount;
  WS_STRING       actor;
  WS_STRING       node;
  WS_XML_BUFFER   *detail;
} WS_FAULT;

Membros

code

O cabeçalho da lista de códigos de falha que identifica o tipo de falha.

Os códigos de falha são ordenados da mais genérica para a mais específica. Deve haver pelo menos um código de falha. O primeiro código de falha deve corresponder a um código de falha definido por SOAP. Por WS_ENVELOPE_VERSION_SOAP_1_1, somente o código de falha mais específico é serializado (o primeiro na lista).

Se o URI do namespace do primeiro código de falha for a cadeia de caracteres vazia, o primeiro código de falha será transformado da seguinte maneira quando a falha for serializada, da seguinte maneira:

Essas transformações permitem que um código de falha SOAP seja especificado sem precisar se preocupar com qual versão SOAP é usada.

reasons

O texto que descreve a falha. Essa é uma matriz para permitir idiomas diferentes.

reasonCount

O número de motivos na matriz de motivos. Isso seria mais de um se o texto fosse representado em vários idiomas. Deve haver pelo menos uma razão de falha.

Por WS_ENVELOPE_VERSION_SOAP_1_1, apenas o primeiro motivo é serializado.

actor

O nome do processador que causou a falha. Se a cadeia de caracteres tiver comprimento zero, será considerado o ponto de extremidade.

node

O local do processador que causou a falha. Se a cadeia de caracteres tiver comprimento zero, será considerado o ponto de extremidade.

Para WS_ENVELOPE_VERSION_SOAP_1_1, esse valor não é serializado.

detail

Os detalhes da falha permitem que o conteúdo XML seja incluído junto com a falha. Se não houver detalhes, esse campo poderá ser NULL.

Por WS_ENVELOPE_VERSION_SOAP_1_1, isso só deverá ser usado se a falha não estiver relacionada ao processamento de um cabeçalho da mensagem. As falhas relacionadas aos cabeçalhos devem usar um cabeçalho personalizado para retransmitir informações sobre a falha.

Se houver detalhes para a falha, o WS_XML_BUFFER deverá conter um elemento que corresponda ao elemento de detalhes de uma falha SOAP. O conteúdo XML específico da falha está contido no elemento detail. O nome local e o namespace do elemento são ignorados; eles são substituídos pelo nome do elemento apropriado de acordo com o WS_ENVELOPE_VERSION quando o elemento de detalhes é gravado.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho webservices.h