estructura WS_FAULT (webservices.h)
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:
- El espacio de nombres SOAP adecuado se usará en función del WS_ENVELOPE_VERSION.
- Si el nombre local es "Sender" al usar WS_ENVELOPE_VERSION_SOAP_1_1, se usará "Client" en su lugar.
- Si el nombre local es "Receiver" al usar WS_ENVELOPE_VERSION_SOAP_1_1, se usará "Server" en su lugar.
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 |