DbiInit

C syntax

DBIResult DBIFN DbiInit (pEnv);

Delphi syntax

function DbiInit (pEnv: PDbiEnv): DBIResult stdcall;

Description

DbiInit initializes the BDE environment.

Parameters

pEnv Type: pDBIEnv (Input)
Pointer to the DBIEnv structure. Optional. Can be used to change the working directory and the location of the configuration file, to set up the language driver, and to supply BDE with the client name.

Usage

Initializes the BDE environment. Default settings can be overwritten by supplying the appropriate settings. If pEnv is NULL, then BDE assumes that the start-up directory is the working directory. In this case, szClientName is empty and bForceLocalInit is FALSE.

Prerequisites

DbiInit must be called once by each client application before any other calls (DbiOpenDatabase, DbiOpenTable, and so on.) are made. The client should be familiar with the environment parameters such as working directory, BDE configuration file path, and so on.

DbiResult	Meaning
DBIERR_NONE	The BDE environment was initialized successfully.
DBIERR_MULTIPLEINIT	Illegal attempt to initialize BDE more than once.
DBIERR_OSACCESS	Attempting to run a BDE application from a Windows NT directory without write access; create a Windows NT TEMP directory to avoid this.