PowerBuilder.Application server object
Description
PowerBuilder.Application is an automation server. The OLE
client that starts the automation server can be PowerBuilder or
some other client that supports automation and automation object
types.
Accessing objects by means of the server You can access PowerBuilder objects using automation by:
- Connecting an OLEObject
(or the equivalent object type in other client applications) to
PowerBuilder.Application, which starts PowerBuilder as a server
application. - Setting properties of PowerBuilder.Application to
specify the PowerBuilder libraries you want to access. - Calling functions that create class user objects
(nonvisual) in those libraries and assigning those objects to additional
OLEObject variables. - Accessing the properties and functions of the user
objects using automation syntax.
Programmable object in the registry PowerBuilder.Application is not a class in the PowerBuilder
system object hierarchy. It is a programmable object registered
in the Windows registry. To see it in the Browser, click the OLE
tab and expand the Programmable Objects category.
Properties
| Property | Datatype | Description |
|---|---|---|
| LibraryList | String | A list of file names separated by semicolons that are the DLLs or PBDs containing the objects you will access in your PowerBuilder.Application session. All the libraries should have the same executable type, either |
| MachineCode | Boolean | Specifies whether the objects you will instantiate are generated with machine code or Pcode. Values are:
Setting MachineCode is effective only before you create any |
Functions
| Function | Datatype returned | Description |
|---|---|---|
| CreateObject | OLEObject | Creates an instance of a class user object in an OLE server session. An object reference is returned to the client session so that the client can access its properties and functions by means of automation syntax. |
| GenerateGUID | Long | Generates a globally unique identifier and puts the string representation of the identifier in a string variable passed by reference. A network card is required for this function to succeed. |
| GenerateRegFile | Long | Generates a file that contains instructions for updating the registry with information about a PowerBuilder object that you want to deploy as an independent automation server. |
| GenerateTypeLib | Long | Generates a type library file with browsing information about a PowerBuilder object that you want to deploy as an independent automation server. |