GetContextService

Description

Returns 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

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

See also

BeginTransaction (obsolete)

GetCompanyName

GetContextKeywords

GetHostObject

GetMajorVersion

GetMinorVersion

GetName

GetShortName

GetURL

GetVersionName

HyperLinkToURL

Init (obsolete)

PostURL