Soap.InvokeRegistry.RemTypeRegistry

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function RemTypeRegistry: TRemotableTypeRegistry;

C++

extern DELPHI_PACKAGE TRemotableTypeRegistry* __fastcall RemTypeRegistry(void);

Properties

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

Description

Provides access to the remotable type registry.

Call RemTypeRegistry to access to the remotable type registry. Use the RegisterXSClass method of the returned object to register a remotable class in an application that publishes or uses Web Services. Use its RegisterXSInfo method to register a remotable type.

Remotable classes are classes that can be transmitted between the client of a Web Services application and the server that implements the service. They can be used to represent non-scalar types for parameters and return values, or they can represent exceptions that occur when trying to execute a request to a Web Service application. All remotable classes are compiled with runtime type information (RTTI) and have a virtual constructor that the remotable class registry recognizes and uses to obtain class instances.

Remotable types include dynamic arrays, enumerated types, and boolean types, which can be used in an invokable interface without resorting to a remotable class representation, but which must be registered because their values require special marshaling.

Both the client application and server application must register remotable classes and types before they can use them. They must register them to use the same namespace. You can either supply this namespace explicitly when you register the class or type, or you can use the automatically generated namespace. If you use the automatically generated interface, the class must be defined in the same unit on both client and server, and both client and server must have the same value set for the global AppNameSpacePrefix variable.

Note: The remotable type registry is the same thing as the remotable class registry. You can use RemTypeRegistry interchangeably with the RemClassRegistry function.

See Also