CreateEngine Function
Description
Creates a reference to an OpenEngine, running either locally or remotely.
Syntax
Error = CreateEngine(Engine, ServerSpec, DatabaseName, Flags, ShutdownSessions)
Parameters
The CreateEngine function has the following parameters.
| Parameter | Description |
|---|---|
| Engine | Handle for the engine. Pass null. CreateEngine will return an engine handle. |
| ServerSpec | Descriptor for local or remote server. Examples: ServerSpec Description "" - Use default named pipe on local server .\MYENGINE - Use the named pipe MYENGINE on this machine. 192.168.0.1\MYENGINE - Use the named pipe MYENGINE on the server at 192.168.0.1 192.168.0.1:666\MYENGINE - Use the named pipe MYENGINE on the server at 192.168.0.1, port 666 |
| DatabaseName | The database .dbt file to use. |
| Flags | See CreateEngine Constants. |
| ShutdownSessions | 0 - Leave the engine running after this session closes 1 - Causes the engine to shut down sessions when this connection is closed. |
See Also
Example
// Create an engine that will not shut down when the connections end // Uses the named pipe REVCAPI_TEST Error = CreateEngine(Engine, "\\.\REVCAPI_TEST", "EXAMPLES",**CREATE_ENGINE_OPEN_ALWAYS$, 1)**