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:
|
|
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
