Object interface  RecordSet interface

Chapter 4: ActiveX Client Interfaces

Orb interface

Description

Type library name

JaguarTypeLibrary

DLL name

jagproxy.dll

The core interface used by clients that use CORBA-style proxy instantiation.

Methods

Usage

Orb is the core interface used by clients for CORBA-style proxy instantiation. In Visual Basic, construct an instance with the new keyword, as in this example:

Dim orbRef as JaguarTypeLibrary.Orb
set orbRef = new JaguarTypeLibrary.Orb

You can create multiple Orb instances, though there is no need to do so unless each is initialized differently by passing different properties to the Init method.




Orb.Init

Description

Initializes the Orb instance.

Syntax

Orb.Init ( options as String )

Parameters

options

A string containing zero or more initialization parameter settings, formatted as follows:

orb.init("param1=setting1,param2=setting2")

As shown in the example, parameter names and values must be separated by an equals sign, ‘=’, and each name/value pair must be separated from the next with a comma and no white space.

Usage

Init initializes an Orb instance. You must call Init once for each Orb instance before calling any other method. It is an error to call Init more than once on one instance. You can create several Orb instances and initialize them with different parameters.


Initialization Parameters

You can pass initialization parameters to the driver class by embedding settings in a formatted string, or setting environment variables. If both the environment variable and initialization parameter are set, the value of the initialization parameter is used. You can set any initialization parameter to a value of none, which overrides the value of the environment variable and sets the value to the default, if any.

You can pass settings for the following propertys to the driver class:

Properties that configure SSL connections can also be set using the CtsSecurity.SSLServiceProvider interface, or by callback methods in a CtsSecurity.SSLCallback object that you install using the ORBAXSSLCBComponent property.


Example

This example creates an Orb instance and configures the -ORBlogFile property and the -ORBpin property, to specify a file name for logging errors and the Sybase SSL-certificate-database password, respectively:

Dim orb as JaguarTypeLibrary.Orb
set orb = new JaguarTypeLibrary.Orb
orb.init("-ORBlogFile=d:\jagorb.log,-ORBpin=sybase")

See also

CtsSecurity.SSLServiceProvider interface




Orb.resolve_initial_references

Description

Obtains a proxy for a client-side service.

Syntax

Orb.resolve_initial_references ( 
    serviceName as String 
    ) as Object

Parameters

serviceName

A string containing the name of the service. The following names are recognized:

Service name

Returned object

SSLServiceProvider

An instance of CtsSecurity.SSLServiceProvider.

Returns

An Object (IDispatch pointer) that must be narrowed to the interface implemented by the service by calling the Object.Narrow_ method, as follows:

Service name

Type name for Object.Narrow_

SSLServiceProvider

CtsSecurity/SSLServiceProvider




Orb.object_to_string

Description

Obtains a serialized string Interoperable Object Reference (IOR) for a proxy instance.

Syntax

Orb.object_to_string(objRef as JaguarTypeLibrary.Object) as String

Parameters

objRef

The proxy instance to be serialized. The instance must have been obtained from the EAServer ActiveX proxy server.

Returns

A string that encodes the proxy object in CORBA IOR format.

Usage

object_to_string serializes a proxy object into a string, using the CORBA IOR format. You can call string_to_object to deserialize the object later.

See also

string_to_object




Orb.string_to_object

Description

Deserializes a string that contains a CORBA IOR representing a proxy for a EAServer comonent.

Syntax

Orb.string_to_object(ior as String) as Object

Parameters

ior

A string that was returned by object_to_string, or as a special case when obtaining a SessionManager.Manager instance, a URL formatted as follows:

protocol://host:port

Where protocol is iiop or iiops and host:port is the server’s listener host address and port number. See SessionManager.Manager for more information.

Returns

An Object (IDispatch pointer) that must be narrowed to an instance of the appropriate interface by calling the Object.Narrow_ method.

Usage

string_to_object deserializes an object that was serialized using object_to_string.

The following restrictions apply when serializing and deserializing component proxy references:

See also

object_to_string





Copyright © 2005. Sybase Inc. All rights reserved. RecordSet interface