Returns a reference to a context-specific instance of the specified service.
Any object
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. |
Integer. Returns 1 if the function succeeds and a negative integer if an error occurs. The return value -1 indicates an unspecified error.
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. On all EAServer platforms except AIX, you must use Keyword.
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.
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)
...