From RAD Studio API Documentation
Jump to: navigation, search



TXSHexBinary = class(TRemotableXS)


class PASCALIMPLEMENTATION TXSHexBinary : public Soap::Invokeregistry::TRemotableXS


Type Visibility Source Unit Parent
class public
Soap.XSBuiltIns Soap.XSBuiltIns


TXSHexBinary implements the XML schema hexBinary type so that it can be used on invokable interfaces.

TXSHexBinary acts as a wrapper for the simple scalar hexBinary type that W3C defines for XML schemas. Because this type does not correspond directly to a Delphi or C++ type, it requires special marshaling when used in an invokable interface. TXSHexBinary enables this marshaling because it is a descendant of TRemotable.

Use the AsByteArray property to get or set the value of TXSHexBinary as an array of bytes. You can also set the value of TXSHexBinary from an integer using the global IntToHex function to convert an integer into a hexadecimal string and setting the HexBinaryString property.

On server applications, instances of TXSHexBinary that are input parameters on an invokable interface are automatically created when the method call is unmarshaled and automatically freed after any output parameters or return value are marshaled so that they can be sent to the client. When a TXSHexBinary instance is created in a method that was called remotely using an invokable interface, the instance is automatically freed after the value of the TRemotable descendant is marshaled for transport back to the client application.

The caller of an invokable interface (client) is responsible for creating any TXSHexBinary instances that it passes as input parameters, and for freeing any TXSHexBinary instances it creates or that are returned as output parameters or method results.

See Also