DbiFormFullName        

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiFormFullName        

Return to chapter overview

C syntax

DBIResult DBIFN DbiFormFullName (hDb, pszTableName, pszDriverType, pszFullName);

Delphi syntax

function DbiFormFullName (hDb: hDBIDb; pszTableName: PChar; pszDriverType: PChar; pszFullName: PChar): DBIResult stdcall;

Description

DbiFormFullName returns the fully qualified table name.

Parameters

hDb                Type: hDBIDb                (Input)
Specifies the database handle.

pszTableName                Type: pCHAR                (Input)
Pointer to the table name.

pszDriverType                Type: pCHAR                (Input)
Pointer to the driver type.

pszFullName                Type: pCHAR                (Output)
Pointer to the client buffer that receives the fully qualified table name. pszFullName should be allocated for DBIMAXTBLNAMELEN.

Usage

If the given table name contains a beginning drive letter followed by a colon, this function simply returns the same table name that was passed in without changing it. Otherwise, this function qualifies the table name using the directory associated with the supplied database handle. You can use DbiSetDirectory to change this directory. The table name need not be an existing file.

DbiResult

Meaning

DBIERR_NONE

The table name has been successfully returned.

DBIERR_INVALIDFILENAME

The specified table name is invalid. This might occur if the combined length of the directory and table name are greater than DBIMAXTBLNAMELEN). Output pszFullname is left unchanged.

See also

DbiSetDirectory