CreateObject method

Creates an internal AFP object and returns a reference to it.

Syntax

Server.CreateObject( cObjectName )

Parameter

cObjectName

The name of the requested object as a character string. Of the values listed in the table below, only one is valid. Use the Visual FoxPro function CREATEOBJECT() to create other objects or to load a COM server.

Returned value

Returns either a reference to the required object or .NULL. Depending on the object this may be a reference either to an existing global instance or to a new private instance of the object. Private objects without dedicated data sessions of their own are created during server object data sessions. If you require an instance of this object in the data session of another AFP object, invoke the CreateObject method of that object.

Documents will be available only during AFP document execution and under the names described in this documentation. If you use special Plugins or other Call objects, you have to determine these references through Server.CreateObject(). Hence this function lets you also determine those references to objects that are available in AFP documents through simpler methods. There is no difference between the two access methods.

Object	Description
Response	Global response object
Request	Global request object
Session	Global session object
Server	Global server object
Config	Reference to a new config object
Applications	Global applications object
PlugIns	Global plugins object

Remarks

All AFP objects, with the exception of pure data objects, have this method.