GetContextService

Description

Creates a reference to a context-specific instance of the specified service.

Applies to

Any object

Syntax

GetContextService ( servicename, servicereference )

Argument	Description
servicename	String specifying the service object. Valid values are: ContextInformation—Context information service ContextKeyword—Context keyword service CORBACurrent—(PowerBuilder only) CORBA current service for client- or component-management of EAServer transactions ErrorLogging—(PowerBuilder only) Error logging service for PowerBuilder components running in a transaction server such as EAServer or COM+ Internet—Internet service SSLServiceProvider—(PowerBuilder only) SSL service provider service that allows PowerBuilder clients to establish SSL connections to EAServer components TransactionServer—(PowerBuilder only) Transaction server service for PowerBuilder components running in a transaction server such as EAServer or COM+
servicereference	PowerObject into which the function places a reference to the service object specified by servicename. This argument is passed by reference.

Argument

Description

servicename

String specifying the service object. Valid values are:

ContextInformation—Context information service
ContextKeyword—Context keyword service
CORBACurrent—(PowerBuilder only) CORBA current service for client- or component-management of EAServer transactions
ErrorLogging—(PowerBuilder only) Error logging service for PowerBuilder components running in a transaction server such as EAServer or COM+
Internet—Internet service
SSLServiceProvider—(PowerBuilder only) SSL service provider service that allows PowerBuilder clients to establish SSL connections to EAServer components
TransactionServer—(PowerBuilder only) Transaction server service for PowerBuilder components running in a transaction server such as EAServer or COM+

servicereference

PowerObject into which the function places a reference to the service object specified by servicename. This argument is passed by reference.

Returns

Integer. Returns 1 if the function succeeds and a negative integer if an error occurs. The return value -1 indicates an unspecified error.

Usage

Call this function to establish a reference to a service object, allowing you to access methods and properties in the service object. You must call this function before calling service object functions.

Using a CREATE statement You can instantiate these objects with a PowerScript CREATE statement. However, this always creates an object for the default context (native PocketBuilder execution environment), regardless of where the application is running.

Examples

Example 1

This example calls the GetContextService function and displays the class of the service in a single line edit box:

Integer li_return

ContextKeyword lcx_key

li_return = this.GetContextService &

    ("ContextKeyword", lcx_key)

sle_classname.Text = ClassName(lcx_key)

...

GetContextService

Description

Applies to

Syntax

Returns

Usage

Examples

Example 1

See also