estructura WS_FAULT (webservices.h)

  • Artículo

Un error es un valor que se lleva en el cuerpo de un mensaje que transmite un error de procesamiento. Los errores se modelan mediante la estructura WS_FAULT .

Sintaxis

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;

Miembros

code

Encabezado de la lista de códigos de error que identifica el tipo de error.

Los códigos de error se ordenan de la mayoría de los genéricos a los más específicos. Debe haber al menos un código de error. El primer código de error debe corresponder a un código de error definido por SOAP. Para WS_ENVELOPE_VERSION_SOAP_1_1, solo se serializa el código de error más específico (el primero de la lista).

Si el URI del espacio de nombres del primer código de error es la cadena vacía, el primer código de error se transformará de la siguiente manera cuando se serialice el error, como se indica a continuación:

Estas transformaciones permiten especificar un código de error SOAP sin tener que preocuparse por qué versión de SOAP se usa.

reasons

Texto que describe el error. Se trata de una matriz que permite distintos idiomas.

reasonCount

Número de motivos de la matriz reasons. Esto sería más de uno si el texto se representase en varios idiomas. Debe haber al menos un motivo de error.

Por WS_ENVELOPE_VERSION_SOAP_1_1, solo se serializa la primera razón.

actor

Nombre del procesador que provocó el error. Si la cadena es de longitud cero, se supone que es el punto de conexión.

node

Ubicación del procesador que provocó el error. Si la cadena es de longitud cero, se supone que es el punto de conexión.

Por WS_ENVELOPE_VERSION_SOAP_1_1, este valor no se serializa.

detail

El detalle del error permite incluir contenido XML junto con el error. Si no hay ningún detalle, este campo puede ser NULL.

Por WS_ENVELOPE_VERSION_SOAP_1_1, esto solo se debe usar si el error no está relacionado con el procesamiento de un encabezado del mensaje. Los errores relacionados con los encabezados deben usar un encabezado personalizado para retransmitir información sobre el error.

Si hay detalles del error, el WS_XML_BUFFER debe contener un elemento que corresponda al elemento de detalle de un error soap. El contenido XML específico del error se encuentra dentro del elemento de detalle. Se omiten el nombre local y el espacio de nombres del elemento; se reemplazan por el nombre de elemento adecuado según el WS_ENVELOPE_VERSION cuando se escribe el elemento de detalle.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h