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.

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.

NoteUsing 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)

...

See also