Soap.InvokeRegistry.ERemotableException

From RAD Studio API Documentation
Jump to: navigation, search

System.SysUtils.ExceptionSystem.TObjectERemotableException

Delphi

ERemotableException = class(Exception)

C++

class PASCALIMPLEMENTATION ERemotableException : public System::Sysutils::Exception

Properties

Type Visibility Source Unit Parent
class public
Soap.InvokeRegistry.pas
Soap.InvokeRegistry.hpp
Soap.InvokeRegistry Soap.InvokeRegistry

Description

ERemotableException is the class for exceptions that can be communicated from a Web Service application to a client application.

ERemotableException is the exception class for exceptions that a client raises based on a SOAP fault packet that it receives from a Web Service application. The ERemotableException properties represent standard elements of the SOAP fault packet.

Create an ERemotableException descendant to define a custom exception class for problems encountered when executing the methods of an invokable interface in a Web Service application. When a Web Service application raises an ERemotableException descendant in the course of executing a request from a client application, it adds the values of any published properties to the fault packet, in addition to the value of the Message property. Note that these published properties must be remotable types; that is, the value must be a scalar type, or it must be a registered descendant of TRemotable.

Before the properties of an ERemotableException descendant can be transmitted in a fault packet, it must be registered with the remotable type registry (RemTypeRegistry). Call the RegisterXSClass method of the remotable type registry, on both the client and the server application, to enable your exception class to be transmitted.

The properties of ERemotableException support either the SOAP 1.1 or SOAP 1.2 properties.



Property SOAP version

FaultActor

SOAP 1.1

FaultCode

SOAP 1.1 and SOAP 1.2

FaultDetail

SOAP 1.1 and SOAP 1.2

FaultReason

SOAP 1.1 and SOAP 1.2

FaultReasonLang

SOAP 1.2

FaultNode

SOAP 1.2

FaultRole

SOAP 1.2



See Also