SharedObjectRegister PowerScript function
Description
Registers a user object so that it can be shared.
Syntax
|
1 |
<span>SharedObjectRegister</span> (<span> classname</span> , <span>instancename</span> ) |
|
Argument |
Description |
|---|---|
|
classname |
The name of the user object that you |
|
instancename |
A string whose value is the name you |
Return Values
ErrorReturn. Returns one of the following values:
-
Success! – The function
succeeded -
SharedObjectExistsError! – The instance
name has already been used -
SharedObjectCreateInstanceError! – The
object could not be created -
SharedObjectCreatePBSessionError! – The
shared object session could not be created
Usage
When you call the SharedObjectRegister function,
PowerBuilder opens a separate runtime session for the shared object
and creates the shared object. The name you specify for the object
instance provides a way for you to access the object instance with
the SharedObjectGet function.
You can use a shared object on a PowerBuilder client to simulate
an asynchronous call to EAServer.
For more information, see the description of the SharedObjectGet function.
Examples
In this example, the user object uo_customers is
registered so that it can be shared. The name assigned to the shared
object instance is share1. After registering
the object, the application uses the SharedObjectGet function
to store an instance of the object in an object variable:
|
1 |
<span>SharedObjectRegister</span>("uo_customers", "share1") |
|
1 |
SharedObjectGet("share1",shared_object) |