GetContextService

PowerScript function

Description

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

Applies to

Any object

Syntax

GetContextService ( servicename, servicereference )

1	GetContextService ( servicename, servicereference )

Argument	Description
servicename	String specifying the service object. Valid values are: ContextInformation — Context information service ContextKeyword — Context keyword service ErrorLogging — Error logging service for PowerBuilder components running in a transaction server such as COM+ Internet — Internet service TransactionServer — Transaction server service for PowerBuilder components running in a transaction server such as 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
ErrorLogging — Error logging service for PowerBuilder
components running in a transaction server such as
COM+
Internet — Internet service
TransactionServer — Transaction server service for
PowerBuilder components running in a transaction server such
as COM+

servicereference

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

Return value

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.

In Windows applications, you can use ContextKeyword or Keyword as
the servicename argument when you get an instance of the ContextKeyword
service.

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 PowerBuilder execution environment), regardless of where
the application is running.

Examples

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 &amp;
    ("Keyword", lcx_key)
sle_classname.Text = ClassName(lcx_key)
...