DbiStartSession

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiStartSession

Return to chapter overview

C syntax

DBIResult DBIFN DbiStartSession ([pszName], phSes, [pNetDir]);

Delphi syntax

function DbiStartSession (pszName: PChar; var hSes: hDBISes; pNetDir: PChar): DbiResult stdcall;

Description

DbiStartSession starts a new session for the client application.

Parameters

pszName                Type: pCHAR                (Input)
Pointer to the session name. Allows you to name the newly created session; if NULL, BDE names the session. Optional.

phSes                Type: phDBISes                (Output)
Pointer to the session handle. Used to identify the session.

pNetDir                Type: pCHAR                (Input)
Pointer to the network file directory for the session. This directory is used for Paradox locking. Use of this pointer allows you to have different NETDIRs for distinct sessions.

Usage

Use DbiStartSession to create different concurrency schemes.

Completion state

DbiStartSession makes the new session the current session.

DbiResult

Meaning

DBIERR_NONE

The session was successfully started.

DBIERR_INVALIDHNDL

phSes is NULL.

DBIERR_SESSIONSLIMIT

The maximum number of sessions are open.

See also

DbiSetCurrSession, DbiCloseSession